AI客户端服务集线器

MCP-Hub是一个集中管理多个AI客户端(如Claude Code)服务的集线器,通过单一进程减少资源占用并提高启动速度。

  • by dapi
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 dapi/mcp-hub

使用说明

MCP集线器

MCP服务器集中式集中式集线器 克劳德代码 以及其他AI客户。 一个过程,而不是十个。Git中的所有设置建立在 MCPHub.

问题

标准方法-每个Claude Code会话都以stdio进程运行MCP服务器:

graph LR
    S1[Claude Code #1] -->|stdio| P1[playwright]
    S1 -->|stdio| T1[tavily]
    S1 -->|stdio| G1[google]
    S2[Claude Code #2] -->|stdio| P2[playwright]
    S2 -->|stdio| T2[tavily]
    S2 -->|stdio| G2[google]
  • 进程重叠。 5个会话×7个服务器=35个进程
  • 慢启动。 每次启动会话-5-15秒
  • 设置是分散的。 ~/.claude.json,系统单元,不同的配置
  • 没有版本化。 更改配置-重新启动所有会话

决定

一个mcphub进程存储所有服务器。会话通过SSE即时连接:

graph LR
    S1[Claude Code #1] -->|SSE| HUB[MCPHub :9700]
    S2[Claude Code #2] -->|SSE| HUB
    S3[Cursor / другой AI] -->|SSE| HUB
    HUB -->|stdio| P[playwright]
    HUB -->|stdio| T[tavily]
    HUB -->|stdio| G[google_workspace]
    HUB -->|stdio| TG[telegram]
    HUB -->|stdio| M[magic]
    HUB -->|stdio| C7[context7]
    HUB -->|stdio| SB[smartbear]
    HUB -->|stdio| D[docmost]
  • 一组进程 所有会话和所有AI客户
  • 即时连接 服务器已运行
  • 全部在Git -配置版本化,使用命令搜索
  • 一个 make restart 所有的会议都有变化。

快速开始

  1. 倾斜并安装:

    git clone git@github.com:dapi/mcp-hub.git
    cd mcp-hub
    make install    # проверит Node.js, создаст .env
    
  2. 将API密钥填充到 .env

  3. 运行:

    make setup      # настроит автозапуск (systemd/launchd)
    make start
    make open       # откроет dashboard
    
  4. 将服务器连接到客户端:

    make claude-install    # установит все серверы в Claude Code
    make codex-install     # установит все серверы в Codex CLI
    
  5. 重新启动客户端会话(Claude/Codex)

从单个MCP服务器迁移

如果MCP服务器通过STDIO或作为独立的SystemD服务运行:

1.将服务器配置迁移到mcpu settings.json

将服务器添加到 mcp_settings.json (格式与STDIO相同)

2.从Claude Code中删除旧的stdio服务器

claude mcp remove playwright

3.停止系统服务(如果有)

systemctl --user disable --now playwright-mcp
rm ~/.config/systemd/user/playwright-mcp.service
systemctl --user daemon-reload

4.通过集线器连接所有服务器

make claude-install
make codex-install

5.重新启动集线器

make restart

命令

团队描述 |---------|----------| | make install 要检查依赖性,创建.env。 | make install-deps –安装CLI工具(Himalaya,TGCLI,GH)→ | make start 启动McPhub | make stop 停止McPhub | make restart 重新启动McPhub | make status 显示状态 | make logs 显示logy | make setup 设置自动启动(systemd/launchd) | make unsetup 删除自动启动。 | make open 打开Dashboard | make claude-install 在Claude Code中安装所有MCP服务器 | make claude-uninstall 从Claude Code中删除所有MCP服务器 | make codex-install 在Codex CLI中安装所有MCP服务器 | make codex-uninstall 从Codex CLI中删除所有MCP服务器。 | make codex-update 重新安装所有MCP服务器到Codex CLI | make mcp-install »Alias for make codex-install | | make mcp-reinstall »Alias for make codex-update | | make install-telegram 安装MCP-Telegram | make telegram-sign-in 登录Telegram

添加新服务器

  1. 添加到 mcp_settings.json:

    "my_server": {
      "command": "npx",
      "args": ["-y", "my-mcp-server"],
      "env": { "API_KEY": "${MY_API_KEY}" }
    }
    

    重要的是: 字段 "args" 如果是空的话([])

  2. 将变量添加到 .env

  3. 重新启动集线器并更新Claude Code:

    make restart
    make claude-install
    make codex-install
    

CLI工具

有些工具最好直接通过CLI使用,而不是通过MCP服务器使用。原因:

  • 速度 -直接呼叫CLI比通过MCP路由更快
  • 可靠性 -更少的中间层,更少的故障点
  • 简单 Claude Code通过bash调用它们,无需额外设置

工具安装 |-----------|-----------|-----------| | 喜马拉雅 –电子邮件-阅读、发送、管理→ cargo install himalaya / brew install himalaya | | tgcli –Telegram–从CLI发送消息› pip3 install tgcli | | 鬼 |GitHub-公关,问题,评论,API| apt install gh / brew install gh |

立即安装:

make install-deps

当前服务器

服务器需要密钥。 |--------|-----------|-------------| ÐÐÐÐÐÐÐÐÐÐÐÐÐ | tavily | 网页搜索 | TAVILY_API_KEY | |google_workspace|驱动器、文档、表格|OAuth凭据| ÐtelegramÐÐÐÐÐÐÐÐÐÐÐÐ ÐMAGICÐÐÐÐÐÐÐÐÐÐÐÐ context7ÐÐÐÐÐÐÐÐÐÐÐÐÐ |smartbear|Bugsnag公司| |docmost |维基/|

平台

  • Linux:systemd--用户
  • macOS:launchd

许可证

麻省理工学院