MCP-Hub-MCP 服务器

一个用于连接和管理其他 MCP（模型上下文协议）服务器的中心服务器。

概述

该项目构建了一个 MCP 中心服务器，它可以连接到其他 MCP 服务器，列出它们的工具，并执行这些工具。
它特别适用于绕过 Cursor 的 40 个工具的 MCP 限制。
即使在 Cursor 之外，它也有助于通过隐藏不常用的工具来减少 AI 错误。

主要功能

• 通过配置文件自动连接到其他 MCP 服务器
• 列出已连接服务器上的可用工具
• 调用已连接服务器上的工具并返回结果

配置

将以下内容添加到您的 mcp.json 文件中：

使用 npx

json
{
"mcpServers": {
"mcp-hub": {
"command": "npx",
"args": [
"-y",
"mcp-hub-mcp",
"--config-path",
"/path/to/your/mcp-hub-config.json"
]
}
}
}

使用 Node（例如，用于本地开发或直接执行）

如果 npx 没有检测到您的本地更改，或者您希望直接运行构建后的服务器，您可以这样配置：

json
{
"mcpServers": {
"mcp-hub": {
"command": "node",
"args": [
"/path/to/your/mcp-hub-mcp/dist/index.js",
"--config-path",
"/path/to/your/mcp-hub-config.json"
]
}
}
}

注意： 确保您已经构建了项目（例如，使用 npm run build 或 pnpm build），以便 dist/index.js 存在。

系统提示（或 Cursor 规则）

在处理用户的请求之前，必须使用 "list_all_tools" 命令来识别哪些工具是可用的。

这确保了 AI 助手在尝试使用工具之前总是会检查可用工具。

安装与运行

要求

• Node.js 18.0.0 或更高版本
• npm、yarn 或 pnpm

安装

bash

克隆仓库

git clone
cd mcp-hub-mcp

安装依赖

npm install

或者

yarn install

或者

pnpm install

构建

bash
npm run build

或者

yarn build

或者

pnpm build

运行

bash
npm start

或者

yarn start

或者

pnpm start

开发模式

bash
npm run dev

或者

yarn dev

或者

pnpm dev

配置文件

MCP-Hub-MCP 服务器使用 Claude Desktop 格式的配置文件来自动连接到其他 MCP 服务器。
您可以按以下方式指定配置文件：

1. 环境变量：设置 MCP_CONFIG_PATH 环境变量为配置文件路径
2. 命令行参数：使用 --config-path 选项指定配置文件路径
3. 默认路径：使用当前目录中的 mcp-config.json 文件

配置文件格式：

json
{
"mcpServers": {
"serverName1": {
"command": "command",
"args": ["arg1", "arg2", ...],
"env": { "ENV_VAR1": "value1", ... }
},
"serverName2": {
"command": "anotherCommand",
"args": ["arg1", "arg2", ...]
}
}
}

示例：

json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/Users/username/Downloads"
]
},
"other-server": {
"command": "node",
"args": ["path/to/other-mcp-server.js"]
}
}
}

使用方法

MCP-Hub-MCP 服务器提供了以下工具：

1. list-all-tools

从所有已连接的服务器返回工具列表。

json
{
"name": "list-all-tools",
"arguments": {}
}

2. call-tool

调用特定服务器上的工具。

• serverName：要调用工具的 MCP 服务器名称
• toolName：要调用的工具名称
• toolArgs：传递给工具的参数

json
{
"name": "call-tool",
"arguments": {
"serverName": "filesystem",
"toolName": "readFile",
"toolArgs": {
"path": "/Users/username/Desktop/example.txt"
}
}
}

提交信息约定此项目遵循Conventional Commits规范进行自动版本管理和CHANGELOG生成。

格式：<类型>(<范围>): <描述>

示例：

• feat: 添加新的hub连接功能
• fix: 解决服务器超时问题
• docs: 更新API文档
• chore: 更新依赖项

类型说明：

• feat: 新功能（小版本号递增）
• fix: 修复bug（补丁版本号递增）
• docs: 仅文档更改
• style: 不影响代码含义的更改
• refactor: 既不修复bug也不添加新功能的代码变更
• perf: 提升性能的代码变更
• test: 增加缺失的测试或修正现有测试
• chore: 构建过程或辅助工具的更改

破坏性变更：
在提交信息底部添加BREAKING CHANGE:以触发主版本号递增。

技术栈

• Node.js
• TypeScript
• @modelcontextprotocol/sdk (版本: ^1.9.0)
• zod (版本: ^3.22.4)

许可证

MIT