🚀 MCP-Hub-MCP 服务器

MCP-Hub-MCP 服务器是一个枢纽服务器，可连接并管理其他 MCP（模型上下文协议）服务器。它能突破 Cursor 的工具数量限制，减少 AI 错误，提升使用体验。

🚀 快速开始

MCP-Hub-MCP 服务器可通过配置文件自动连接到其他 MCP 服务器，列出它们的工具并执行。这对于绕过 Cursor 的 40 个工具 MCP 限制特别有用，还能在 Cursor 之外减少 AI 错误。

✨ 主要特性

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

📦 安装指南

先决条件

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

安装

# 克隆仓库
git clone <repository-url>
cd mcp-hub-mcp

# 安装依赖项
npm install
# 或者
yarn install
# 或者
pnpm install

构建

npm run build
# 或者
yarn build
# 或者
pnpm build

运行

npm start
# 或者
yarn start
# 或者
pnpm start

开发模式

npm run dev
# 或者
yarn dev
# 或者
pnpm dev

💻 使用示例

配置

将以下内容添加到 mcp.json 中：

使用 npx

{
  "mcpServers": {
    "other-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-hub-mcp",
        "--config-path",
        "/Users/username/mcp.json"
      ]
    }
  }
}

系统提示（或 Cursor 规则）

在处理用户请求之前，您必须使用“list_all_tools”命令来识别可用的工具。

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

MCP-Hub-MCP 服务器提供的工具

1. list-all-tools

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

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

2. call-tool

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

• serverName: 要调用工具的 MCP 服务器名称。
• toolName: 要调用的工具名称。
• arguments: 工具所需的参数。

请求格式：

{
  "name": "call-tool",
  "arguments": {
    "serverName": "string",
    "toolName": "string",
    "arguments": {}
  }
}

响应将返回所调用工具的结果。

📚 详细文档

配置文件

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

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

配置文件格式：

{
  "mcpServers": {
    "serverName1": {
      "command": "命令",
      "args": ["参数1", "参数2", ...],
      "env": { "ENV_VAR1": "值1", ... }
    },
    "serverName2": {
      "command": "另一个命令",
      "args": ["参数1", "参数2", ...]
    }
  }
}

示例：

{
  "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"]
    }
  }
}

提交规范

采用 Conventional Commits 规范：

• 类型：feat、fix、docs、style、refactor、perf、test。
• 范围：可选，指定提交影响的范围（例如：server, client）。
• 标题：描述性标题，不超过 50 字符。
• 正文：详细说明提交内容。
• footer：可选，包含 BREAKING CHANGE 标签以表示破坏性更改。

🔧 技术细节

技术栈

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

📄 许可证

本项目采用 MIT 许可证。