MCP服务器动态管理器

MCP Supervisor是一款动态启动和管理其他MCP服务器的工具,通过代理方式提供灵活的子服务器管理能力,适用于需要动态配置MCP服务器的开发场景。

  • by miyamiyaz
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 miyamiyaz/mcp-supervisor

使用说明

MCP server that dynamically starts and manages other MCP servers


MCP Supervisor

Why ⚙ Install ⚙ Configure ⚙ Skills ⚙ Tools ⚙ About MCP ↗

为什么

MCP客户端配置是静态的。如果子MCP服务器需要动态参数(例如每次启动都会更改的CDP端点),则每次都必须编辑配置并重新启动客户端。

mcp-supervisor 解决了这个问题。将其配置为MCP服务器一次。它根据需要用任何参数启动子MCP服务器,并通过单个固定连接代理它们的工具。

此外,静态配置的MCP服务器在启动时将所有工具加载到上下文中,即使您不需要它们。使用mcp监控器,子mcp仅在需要时启动,完成后停止,保持上下文窗口干净。

安装

编码代理(Claude Code、Codex、OpenCode等)

将此粘贴到您的代理中:

使用安装mcp监控器https://github.com/miyamiyaz/mcp-supervisor并在以下网址注册 claude mcp add supervisor -- npx -y mcp-supervisor

npx(推荐)

无需安装——直接通过Node.js运行:

claude mcp add supervisor -- npx -y mcp-supervisor

或添加到 .mcp.json:

{
  "mcpServers": {
    "supervisor": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-supervisor"]
    }
  }
}

布置

mise use -g "github:miyamiyaz/mcp-supervisor[exe=supervisor-mcp]"

GitHub发布

从下载二进制文件 GitHub发布 把它放在你的路径中的某个地方。

去安装

go install github.com/miyamiyaz/mcp-supervisor/cmd/supervisor-mcp@latest

配置

克劳德代码

claude mcp add supervisor -- npx -y mcp-supervisor

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "supervisor": {
      "command": "npx",
      "args": ["-y", "mcp-supervisor"]
    }
  }
}

技能

mcp监控器设计用于 Claude代码技能一项技能教克劳德如何通过主管启动和使用特定的MCP服务器。

给Claude MCP的GitHub URL,让他创建一项技能:

使用以下方法为mcp主管创建技能https://github.com/microsoft/playwright-mcp--把它放在.claude/stkillings/browse cdp/SKILL.md中

Claude将阅读回购,了解MCP的工具和参数,并为您生成技能文件。

看 examples/skills/ 对于现成的例子。

工具

工具 说明
start_mcp 启动子MCP服务器并代理其工具
stop_mcp 停止子MCP服务器并删除其工具
list_mcps 列出所有正在运行的子MCP服务器

当儿童MCP启动时 name: "pw",它的所有工具都可以通过 pw. 前缀(例如。 pw.browser_click, pw.browser_navigate).

start_mcp

正是其中之一 command (stdio)或 url (HTTP)必须提供。

参数 类型 必填 说明
name string yes 唯一名称(用作工具前缀)
command string 其中之一 要运行的命令(stdio传输)
args string[] no 命令参数(仅限stdio)
env object no 额外的环境变量,与父变量合并(仅限stdio)
url string 其中之一 HTTP端点URL(可流式HTTP传输)
headers object no HTTP标头,例如。 {"Authorization": "Bearer <token>"}

stop_mcp

参数 类型 必填 说明
name string yes 要停止的MCP的名称

list_mcps

没有参数。

安全

此服务器可以启动任意进程。仅在受信任的计算机上本地运行。不要接触网络。

许可证

麻省理工学院