MCP Server Manager

MCP SSE Launcher

一个基于 Python 的 Model Context Protocol（MCP）服务管理系统，可自动使用 Supergateway 将基于 stdio 的服务封装为 SSE 端点，并提供基于 Web 的检查器用于测试。

主要功能

• 自动更新 - 自动保持 MCP 服务为最新版本
• 后台监控 - 自动重启崩溃的服务
• Web 检查器 - 通过浏览器调试和测试 MCP 服务
• SSE 转换 - 封装基于 stdio 的服务，以便通过 HTTP/SSE 访问
• AI 助手集成 - 可与 Cursor、Claude Desktop 等配合使用

快速开始

# 1. Install dependencies
pip install -r requirements.txt

# 2. Set up environment (copy .env.example to .env and add API keys)
cp .env.example .env

# 3. Start all MCP servers (with auto-restart)
make run-servers

# 4. Start web inspector for debugging
make run-inspector

# 5. View inspector at the URL shown in the output

常见用例

调试特定的 MCP 服务

# Start inspector (will show URL with auth token)
make run-inspector
# Visit the URL shown in output to test MCP servers

添加新的 MCP 服务

# Add GitHub MCP server
python mcp_servers.py add \
  --name github \
  --cmd npx \
  --args "-y @modelcontextprotocol/server-github" \
  --env GITHUB_TOKEN=your_token_here \
  --port 8094

与 Cursor AI 配合使用

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "filesystem": { "url": "http://localhost:8090/sse" },
    "github": { "url": "http://localhost:8094/sse" },
    "brave-search": { "url": "http://localhost:8096/sse" }
  }
}

重启有问题的服务

# Kill conflicts and restart specific server
make restart-server SERVER=github

运行时不自动重启（用于开发）

make run-servers KEEP_ALIVE=0

自动执行的操作

• 更新：启动前检查并更新 npm 包和 git 仓库
• 端口冲突：检测冲突进程，并可将其终止
• 进程监控：服务崩溃后最多重启 3 次
• 日志记录：每个服务的日志记录到 /tmp/<server_name>.log
• 清理：退出时妥善终止所有进程

可用的 MCP 服务

默认配置包含一些常用服务：

• filesystem (8090) - 本地文件访问
• github (8094) - 与 GitHub 仓库交互
• brave-search (8096) - 网页搜索
• fetch (8093) - HTTP 请求
• youtube (8092) - YouTube 搜索/信息
• memory (8100) - 持久化记忆
• puppeteer (8101) - 网页自动化

故障排除

# Check what's using server ports
make check-server-ports

# Kill conflicting processes on server ports
make kill-server-conflicts

# Stop servers (inspector stops with Ctrl+C)
make stop-servers

# View server logs
tail -f /tmp/filesystem.log

配置

服务定义在 mcp_config.json 中。环境变量使用 ${VAR} 语法，并从 .env 加载。

服务配置示例：

{
  "name": "github",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"], 
  "env": {"GITHUB_TOKEN": "${GITHUB_TOKEN}"},
  "port": 8094,
  "server_type": "stdio"
}