MCP Controller

MCP开发工具

提供方 eli0shin

开发工具 未标注 无需鉴权 社区 / 第三方

MCP控制器是一个模型上下文协议代理服务器,提供工具过滤功能,控制客户端可访问的工具。

一句话选型结论

按资料字段整理

MCP Controller 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

协议代理TypeScript本地部署工具过滤访问控制安全网关开发工具

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Controller当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方eli0shin上游标注的维护方 eli0shin
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.5 KB
来自项目仓库与上游目录的原文,未做删改

MCP控制器

模型上下文协议(MCP)服务器,充当MCP客户端和目标MCP服务器之间的代理,具有 工具过滤 控制哪些工具暴露给客户端的能力。

主要特点

  • 🔧 工具筛选:有选择地启用或禁用目标MCP服务器上的特定工具
  • 🔍 透明代理:转发所有其他MCP协议消息,无需修改
  • ⚡ 零配置:无需更改即可与任何现有的MCP服务器配合使用
  • 🛡️ 访问控制:控制客户端可以访问哪些工具以确保安全性和可用性
  • 📦 命令行界面:通过命令参数启动任何MCP服务器
  • 🔄 优雅地关闭:处理SIGINT/SIGTERM信号以清理进程
  • 📝 TypeScript:配备现代ES模块的全型安全

安装```bash

curl -fsSL https://raw.githubusercontent.com/eli0shin/mcp-controller/main/install.sh | bash


或者通过npm安装:```bash
npm install -g mcp-controller

用法

基本代理(无筛选)```bash

Proxy to a local MCP server

mcp-controller bun run my-server.ts

Proxy to an npm-distributed MCP server

mcp-controller @modelcontextprotocol/server-sequential-thinking

Proxy to a Python MCP server

mcp-controller python -m my_mcp_server

Proxy to any executable MCP server

mcp-controller node server.js --port 3000


### 工具筛选

控制将目标服务器中的哪些工具暴露给客户端:```bash
# Only allow specific tools (whitelist mode)
mcp-controller --enabled-tools file-read,file-write,search bun run my-server.ts

# Block specific tools (blacklist mode)
mcp-controller --disabled-tools dangerous-tool,admin-commands python -m my_server

# Multiple tools (comma-separated, no spaces around commas)
mcp-controller --enabled-tools tool1,tool2,tool3 node server.js

筛选规则

  • --enabled-tools:客户只能使用指定的工具(白名单)
  • --disabled-tools:除指定工具外,所有工具都可用(黑名单)
  • 互斥:您可以使用其中之一 --enabled-tools 或 --disabled-tools,但不是两者都有
  • 区分大小写:工具名称必须与目标服务器中定义的完全匹配
  • 没有空格:使用不带空格的逗号分隔值: tool1,tool2,tool3

用例

安全和访问控制```bash

Production environment - only allow safe read-only tools

mcp-controller --enabled-tools read-file,search,list-files my-server

Development environment - block dangerous operations

mcp-controller --disabled-tools delete-file,format-disk,restart-system my-server


### 客户特定定制```bash
# For a documentation client - only text processing tools
mcp-controller --enabled-tools text-search,summarize,translate content-server

# For an admin interface - block user-facing tools
mcp-controller --disabled-tools user-chat,send-email,post-social admin-server

测试与开发```bash

Test specific functionality by isolating tools

mcp-controller --enabled-tools database-query,cache-get test-server

Debug by excluding problematic tools

mcp-controller --disabled-tools flaky-api,slow-process debug-server


## 原理

1. **流程管理**:代理接受命令参数并生成目标MCP服务器进程
1. **消息拦截**:所有JSON-RPC消息都通过代理双向流动
1. **工具筛选**:当客户要求时 `tools/list`,代理根据您的配置过滤响应
1. **透明转发**:所有其他消息(资源、提示、工具调用等)都保持不变
1. **生命周期管理**:代理处理进程清理和优雅关闭

## 建筑```
MCP Client ↔ MCP Controller ↔ Target MCP Server
(Tool Filtering)

消息流

  1. 客户→ 控制器→ 目标:透明转发所有请求
  2. 目标→ 控制器→ 客户:
    - tools/list 根据配置过滤响应
    - 所有其他响应均保持不变

什么被过滤

  • ✅ tools/list 回应 -根据您的设置过滤工具阵列
  • ❌ 工具调用 -单个工具调用通过(过滤后的工具根本不可用)
  • ❌ 资源 -资源列表和访问权限保持不变
  • ❌ 提示 -提示功能不受影响
  • ❌ 其他消息 -初始化、功能等传递

CLI参考```bash

Usage: mcp-controller [--enabled-tools ] [--disabled-tools ] [args...]

mcp-controller update

Options:
--enabled-tools Comma-separated list of tools to allow (whitelist mode)
--disabled-tools Comma-separated list of tools to block (blacklist mode)

Examples:
mcp-controller bun run server.ts # No filtering
mcp-controller --enabled-tools read,write bun run server.ts # Only allow read,write
mcp-controller --disabled-tools delete python -m server # Block delete tool


## 错误处理

控制器在启动时验证参数,并将退出并显示有用的错误消息:```bash
# Missing command
$ mcp-controller --enabled-tools read
Error: No target command specified

# Both filtering modes
$ mcp-controller --enabled-tools read --disabled-tools write bun server.ts
Error: --enabled-tools and --disabled-tools are mutually exclusive

# Missing tool list
$ mcp-controller --enabled-tools bun server.ts
Error: --enabled-tools requires a value

发展```bash

Install dependencies

bun install

Build release binaries

bun run build

Run via wrapper against the local release build

./bin/mcp-controller bun run tests/fixtures/mcp-server.ts

Run in development mode

bun run dev

Run tests (includes tool filtering tests)

bun test

Update installed binary from GitHub Releases

mcp-controller update

Lint and format

bun run lint
bun run format

Type check

bun run typecheck
```

许可证

麻省理工学院

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
MCP Controller 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Controller 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Controller 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Controller 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Controller 能提供哪些能力?

资料显示能力标签包括 TypeScript、访问控制、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。