MCPHub 🚀

MCPHub 🚀

MCPHub 是一款用于管理 Model Context Protocol（MCP）服务的 Web/扩展混合应用。可以把它看作 MCP 服务的 apt/pip，并提供现代化的 Web 界面和安全的本地系统集成。

🌟 功能

• 📦 浏览和安装 MCP 服务
• ⚙️ 管理服务配置
• 🔐 通过 Chrome 扩展执行安全的本地操作
• 🌐 基于 Web 的界面
• 🔄 实时状态监控
• 🛠️ 环境变量管理
• 📝 集成 Claude Desktop 配置
• 🖥️ 跨平台支持

🚀 快速开始

安装 Chrome 扩展和原生主机

Windows：

1. 克隆此仓库
2. 运行安装脚本：

cd chrome-extension/scripts
windows-install.bat

3. 在 Chrome 中加载扩展：
   • 打开 chrome://extensions/
   • 启用开发者模式
   • 点击“加载已解压的扩展程序”
   • 选择 chrome-extension 目录

MacOS/Linux：

1. 克隆此仓库
2. 运行安装脚本：

cd chrome-extension/scripts
# For MacOS:
./macos-install.sh
# For Linux:
./linux-install.sh

3. 在 Chrome 中加载扩展：
   • 打开 chrome://extensions/
   • 启用开发者模式
   • 点击“加载已解压的扩展程序”
   • 选择 chrome-extension 目录

运行 Web 前端

1. 进入 Web 目录：

cd web

2. 安装依赖：

npm install

3. 启动开发服务器：

npm run dev

4. 在 Chrome 中打开 http://localhost:3000

📁 项目结构

mcphub/
├── chrome-extension/       # Chrome extension
│   ├── manifest.json      # Extension manifest
│   ├── background.js      # Service worker
│   ├── popup/            # Extension popup UI
│   ├── native-host/      # Native messaging host
│   └── scripts/          # Installation scripts
├── web/                  # Next.js frontend
│   ├── src/             # Source code
│   └── package.json     # Dependencies
└── registry/            # Server registry
    └── servers.yaml     # Available servers

⚙️ 配置

Claude Desktop 集成

MCPHub 管理位于以下位置的 Claude Desktop 配置文件：

• Windows：%APPDATA%/Claude/claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

服务配置示例

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

🔄 开发

Chrome 扩展

• 使用 Manifest V3
• 使用原生消息传递执行系统操作
• 自动生成扩展 ID
• 跨平台安装脚本

Web 前端

• Next.js 13 和 TypeScript
• Material-UI 组件
• Chrome 扩展集成
• 实时状态监控

🤝 参与贡献

1. Fork 此仓库
2. 创建功能分支：

git checkout -b feature/amazing-feature

3. 提交更改：

git commit -m 'Add amazing feature'

4. 推送到分支：

git push origin feature/amazing-feature

5. 创建 Pull Request

添加新的 MCP 服务

将服务添加到 registry/servers.yaml：

- name: "Your MCP Server"
  description: "Server description"
  runtime: "node"  # or "python"
  package: "your-package-name"
  version: "1.0.0"
  command_args:
    - "your-command-args"
  env:
    YOUR_ENV_VAR: ""

📝 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

🔗 链接

• 文档
• 问题跟踪
• Model Context Protocol

---