MCP Manager

一个灵活的模型上下文协议 (MCP) 管理器服务器，支持 AI 模型和工具之间的通信。兼容 Claude、MCP Dockmaster 和其他 MCP 客户端。

功能特性

• MCP 服务器管理: 运行多个 MCP 服务器，并通过单一界面进行管理
• 工作模式: 作为其他 MCP 客户端的工作节点运行
• 自动发现: 自动查找 GitHub 和 Smithery 包中的 MCP 服务器
• 工具注册表: 浏览和安装来自 MCP 工具注册表的工具
• WebSocket 通信: 基于 WebSockets 的 JSON-RPC 协议，实现实时通信
• 无头模式: 以无头模式运行，实现 API 优先的操作

快速上手

前提条件

• Node.js (v18+)
• NPM (v8+)

安装

# 克隆仓库
git clone <你的仓库地址>
cd <你的仓库目录>

# 安装依赖
npm install

# 从示例创建 .env 文件
cp .env.example .env

# 编辑 .env 文件以配置你的 MCP Manager
nano .env

运行服务器

# 以开发模式运行
npm run dev

# 构建并以生产模式运行
npm run build
npm run start

配置选项

通过编辑 .env 文件来配置你的 MCP Manager：

# 服务器配置
PORT=5000                  # 主服务器端口
HOST=0.0.0.0               # 绑定到的主机
NODE_ENV=development       # 环境 (development/production)
REUSE_PORT=true            # 是否重用端口

# MCP 端口范围
MCP_PORT_RANGE_START=50050 # MCP 服务器的起始端口
MCP_PORT_RANGE_END=50150   # MCP 服务器的结束端口

# MCP 兼容性设置
MCP_WORKER_MODE=false      # 启用工作模式
MCP_DISCOVERY_ENABLED=true # 启用 MCP 服务器的自动发现
MCP_AUTOSTART_SERVERS=true # 自动启动 MCP 服务器

# Smithery API 配置
SMITHERY_API_KEY=your_smithery_api_key_here # Smithery 包的 API 密钥

将 MCP Manager 与 Claude 和其他 MCP 客户端一起使用

MCP Manager 旨在与各种 MCP 客户端兼容，包括：

• Claude Desktop
• MCP Dockmaster
• Toolbase
• 其他 MCP 兼容客户端

连接到 Claude Desktop

1. 在你的本地机器上运行 MCP Manager
2. 打开 Claude Desktop
3. 进入 Settings > Advanced > MCP Configuration
4. 将 MCP Server URL 设置为 http://localhost:5000/ws
5. MCP Manager 将作为 Claude 中可用的服务器出现

连接到 MCP Dockmaster

1. 在你的本地机器上运行 MCP Manager
2. 打开 MCP Dockmaster
3. 点击 "Add Server"
4. 输入服务器信息：
   • Name: MCP Manager
   • Address: localhost
   • Port: 5000
5. 点击 "Connect"

使用工作模式

MCP Manager 可以作为其他 MCP 客户端的工作节点运行：

1. 在你的 .env 文件中设置 MCP_WORKER_MODE=true
2. 运行 MCP Manager
3. 从你的 MCP 客户端连接到 MCP Manager
4. MCP Manager 将自动发现并注册可用的工具

无头/API 优先操作

MCP Manager 支持 API 优先客户端的无头操作：

GET /?api_key=YOUR_API_KEY&headless=true&auto_connect=true

查询参数：

• api_key: 你的 API 密钥 (如果需要)
• headless: 启用无头模式
• auto_connect: 自动连接到可用的 MCP 服务器
• ws_url: 指定自定义 WebSocket URL
• server_id: 连接到特定的服务器 ID

API 参考

MCP Manager 通过 WebSockets 实现 JSON-RPC 协议。 主要 API 端点是：

ws://localhost:5000/ws

可用方法

• ping: 测试服务器连接
• getServers: 获取所有已注册的服务器
• getServer: 通过 ID 获取服务器
• toggleWorker: 切换服务器的工作状态
• getTools: 获取所有工具
• getToolsByServer: 获取特定服务器的工具
• activateTool: 激活一个工具
• deactivateTool: 停用一个工具
• getStats: 获取服务器统计信息

许可证

MIT