MCP server that dynamically starts and manages other MCP servers

MCP Supervisor

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

Why

MCP client configs are static. If a child MCP server needs dynamic arguments (e.g. a CDP endpoint that changes every launch), you have to edit the config and restart your client every time.

mcp-supervisor solves this. Configure it once as your MCP server. It starts child MCP servers on demand with whatever arguments you need, and proxies their tools through a single fixed connection.

Also, statically configured MCP servers load all their tools into context at startup — even when you don't need them. With mcp-supervisor, child MCPs are started only when needed and stopped when done, keeping your context window clean.

Install

Coding agent (Claude Code, Codex, OpenCode, etc.)

Paste this into your agent:

Install mcp-supervisor using https://github.com/miyamiyaz/mcp-supervisor and register it with claude mcp add supervisor -- supervisor-mcp

mise (recommended)

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

GitHub Releases

Download a binary from GitHub Releases and place it somewhere in your PATH.

go install

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

Configure

Claude Code

claude mcp add supervisor -- supervisor-mcp

Or add to .mcp.json in your project root:

{
  "mcpServers": {
    "supervisor": {
      "type": "stdio",
      "command": "supervisor-mcp"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "supervisor": {
      "command": "supervisor-mcp"
    }
  }
}

Skills

mcp-supervisor is designed to be used with Claude Code skills. A skill teaches Claude how to launch and use specific MCP servers through the supervisor.

Give Claude the MCP's GitHub URL and ask it to create a skill:

Create a skill for mcp-supervisor using https://github.com/microsoft/playwright-mcp — put it in .claude/skills/browse-cdp/SKILL.md

Claude will read the repo, understand the MCP's tools and arguments, and generate the skill file for you.

See examples/skills/ for ready-made examples.

Tools

Tool	Description
`start_mcp`	Start a child MCP server and proxy its tools
`stop_mcp`	Stop a child MCP server and remove its tools
`list_mcps`	List all running child MCP servers

When a child MCP is started with name: "pw", all its tools become available with a pw. prefix (e.g. pw.browser_click, pw.browser_navigate).

start_mcp

Parameter	Type	Required	Description
`name`	string	yes	Unique name (used as tool prefix)
`command`	string	yes	Command to run
`args`	string[]	no	Command arguments
`env`	object	no	Extra env vars (merged with parent)

stop_mcp

Parameter	Type	Required	Description
`name`	string	yes	Name of the MCP to stop

list_mcps

No parameters.

Security

This server can start arbitrary processes. Run only locally on trusted machines. Do not expose to networks.

License

MIT

mcp-supervisor

Quick Install