MCP Hub MCP

🚀 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 許可證。