MCP服务器管理工具

git clone https://github.com/grobomo/mcp-manager.git
cd mcp-manager
python setup.py

Claude Code
    |
    v
mcp-manager (single proxy)
    |
    +-- mcpm(operation, server, tool, arguments)
    |
    v
Backend MCP Servers (started on demand)
  - browser automation
  - API wrappers
  - custom tools

mcpm(operation="<op>", server="<name>", ...)

# List servers
mcpm(operation="list_servers")

# Start a server
mcpm(operation="start", server="browser")

# Call a tool (auto-starts server if needed)
mcpm(operation="call", server="wiki-lite", tool="wiki_search", arguments={"query": "API docs"})

# Add a new server
mcpm(operation="add", server="my-server", command="node", args=["./server.js"], description="My custom server")

# Check memory usage
mcpm(operation="ram")

# 1. Clone and run setup (handles everything)
git clone https://github.com/grobomo/mcp-manager.git
cd mcp-manager
python setup.py

# 2. Open a new Claude Code session

python setup.py              # Full setup (build + configure + verify)
python setup.py --check      # Check prerequisites only
python setup.py --migrate    # Migrate servers from .mcp.json to servers.yaml

servers:
  # Local stdio server (Node.js)
  my-node-server:
    description: My custom Node.js server
    command: node
    args:
      - ./servers/my-server/dist/index.js
    enabled: true
    auto_start: false
    idle_timeout: 300000  # 5 minutes

  # Local stdio server (Python)
  my-python-server:
    description: My Python server
    command: python
    args:
      - ./servers/my-server/server.py
    enabled: true
    auto_start: false

  # NPX server (always latest)
  some-mcp:
    description: Some MCP from npm
    command: npx
    args:
      - some-mcp@latest
    enabled: true
    auto_start: false

  # Remote HTTP server
  remote-api:
    description: Remote API server
    url: https://api.example.com/mcp
    enabled: true
    auto_start: false

# Good - relative path
args:
  - ./managed-servers/my-server/server.py

# Avoid - absolute path (not portable)
args:
  - /home/user/mcp-manager/managed-servers/my-server/server.py

servers:
  wiki-lite:
    idle_timeout: 600000   # 10 minutes (default: 3600000 = 1 hour)
    tags:
      - no_auto_stop       # Never auto-stop this server

mcpm(operation="status")

defaults:
  enabled: true
  async: true
  timeout: 5000

hooks:
  # Pattern matches tool names (* = wildcard, prefix* = prefix match)
  browser_navigate:
    target_server: metrics-server
    target_tool: log_event
    result_contains: "success"      # Only trigger if result contains this
    extract:
      url: args.url                 # Extract from call arguments
      status: "regex:HTTP (\\d+)"   # Extract from result via regex
      source: "literal:${server}"   # Variable substitution
      summary: "result_summary:100" # First 100 chars of result

{
  "mcpServers": {
    "mcp-manager": {
      "command": "node",
      "args": ["path/to/mcp-manager/build/index.js"],
      "allowedServers": ["wiki-lite", "v1-lite"]
    }
  }
}

mcp-manager/
|-- src/
|   |-- index.ts            # Main server, transport, idle checker, config
|   |-- utils.ts            # Shared utilities (sanitizeLog, paths, memory)
|   |-- hooks.ts            # Post-call hook system
|   |-- metrics.ts          # Per-server call metrics
|   |-- binary-filter.ts    # Base64 image/resource interception
|   |-- operations/
|       |-- types.ts        # Shared types (ServerConfig, RunningServer, etc.)
|       |-- index.ts        # Operation barrel exports
|       |-- query/          # list_servers, search, details, tools, status, help
|       |-- call/           # call + middleware (blueprint auto-enable)
|       |-- admin/          # lifecycle, registry (add/remove/discover), usage/ram
|-- tests/                  # 93 tests (node:test + tsx)
|-- build/                  # Compiled JavaScript (tsup ESM)
|-- servers.yaml            # Server registry (gitignored)
|-- hooks.yaml              # Hook config (gitignored)
|-- setup.py                # Installation script