Hub-MCP Server

MCP集线器MCP服务器

连接并管理其他MCP（模型上下文协议）服务器的集线器服务器。

概述

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

主要特点

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

配置

将此添加到您的 mcp.json:

使用npx

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

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

如果 npx 如果您没有获取本地更改，或者您更喜欢直接运行构建的服务器，您可以这样配置它：

{
  "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 存在。

系统提示（或光标规则）

Before processing a user's request, you must use the "list_all_tools" command to identify which tools are available.

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

安装和运行

需求

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

安装

# Clone repository
git clone 
cd mcp-hub-mcp

# Install dependencies
npm install
# or
yarn install
# or
pnpm install

构建

npm run build
# or
yarn build
# or
pnpm build

跑

npm start
# or
yarn start
# or
pnpm start

发展模式

npm run dev
# or
yarn dev
# or
pnpm dev

配置文件

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

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

配置文件格式：

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

例子：

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

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

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

2. call-tool

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

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

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

提交消息约定

该项目如下 常规承诺 用于自动版本控制和CHANGELOG生成。

格式： ():

示例：

• feat: add new hub connection feature
• fix: resolve issue with server timeout
• docs: update API documentation
• chore: update dependencies

类型：

• feat：新功能（MINOR版本凹凸）
• fix：Bug修复（PATCH版本碰撞）
• docs：仅文档更改
• style：不影响代码含义的更改
• refactor：既不修复错误也不添加功能的代码更改
• perf：改进性能的代码更改
• test：添加缺失的测试或更正现有的测试
• chore：对构建过程或辅助工具的更改

重大变更： 添加 BREAKING CHANGE: 在提交页脚中触发主版本升级。

技术栈

• Node.js
• TypeScript
• @modelcontextprotocol/sdk（版本：^1.9.0）
• zod（版本：^3.22.4）

许可证

麻省理工学院