MCP-Hub MCP

MCP-Hub-MCP 服务

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

概览

本项目构建了一个 MCP 中枢服务，通过单一接口连接和管理多个 MCP（模型上下文协议）服务。 它允许你仅在需要时连接不常用的 MCP（例如 Atlassian MCP、Playwright MCP），从而避免上下文使用过多和内容污染。 这可以让活跃工具集保持专注且易于管理，减少 AI 错误并提升性能。

主要功能

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

配置

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

使用 npx

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

安装和运行

要求

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

安装

# Clone repository
git clone <repository-url>
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"
    }
  }
}

3. find-tools

在所有已连接服务中查找与正则表达式模式匹配的工具（类似 grep 的功能）。

• pattern：要在工具名称和描述中搜索的正则表达式模式
• searchIn：搜索范围："name"、"description" 或 "both"（默认："both"）
• caseSensitive：搜索是否区分大小写（默认：false）

{
  "name": "find-tools",
  "arguments": {
    "pattern": "file",
    "searchIn": "both",
    "caseSensitive": false
  }
}

示例模式：

• "file" - 查找所有包含 "file" 的工具
• "^read" - 查找所有以 "read" 开头的工具
• "(read|write).*file" - 查找用于读取或写入文件的工具
• "config$" - 查找所有以 "config" 结尾的工具

输出示例：

{
  "filesystem": [
    {
      "name": "readFile",
      "description": "Read the contents of a file",
      "inputSchema": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "Path to the file to read"
          }
        },
        "required": ["path"]
      }
    },
    {
      "name": "writeFile",
      "description": "Write content to a file",
      "inputSchema": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "description": "Path to the file to write"
          },
          "content": {
            "type": "string",
            "description": "Content to write to the file"
          }
        },
        "required": ["path", "content"]
      }
    }
  ]
}

提交消息规范

本项目遵循 Conventional Commits 进行自动版本管理和 CHANGELOG 生成。

格式：<type>(<scope>): <description>

示例：

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

类型：

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

重大更改： 在提交页脚中添加 BREAKING CHANGE:，以触发 MAJOR 版本升级。

其他链接

• MCP 评价

许可证

MIT