MCPHub 🚀

MCPHub 是一个用于管理模型上下文协议（MCP）服务器的混合型网络/扩展应用程序。可以将其视为适用于 MCP 服务器的 apt 或 pip，具有现代化的网页界面和安全的本地系统集成。

🌟 功能

• 📦 浏览并安装 MCP 服务器
• ⚙️ 管理服务器配置
• 🔐 通过 Chrome 扩展程序进行安全的本地操作
• 🌐 基于网络的界面
• 🔄 实时状态监控
• 🛠️ 环境变量管理
• 📝 集成 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
# 对于 MacOS:
./macos-install.sh
# 对于 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 扩展程序
│   ├── manifest.json      # 扩展程序清单
│   ├── background.js      # 服务工作线程
│   ├── popup/            # 扩展程序弹出窗口 UI
│   ├── native-host/      # 本地消息主机
│   └── scripts/          # 安装脚本
├── web/                  # Next.js 前端
│   ├── src/             # 源代码
│   └── package.json     # 依赖项
└── registry/            # 服务器注册表
    └── servers.yaml     # 可用服务器

⚙️ 配置

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 前端

• 使用 TypeScript 的 Next.js 13
• Material-UI 组件
• 集成 Chrome 扩展程序
• 实时状态监控

🤝 贡献

1. 分叉仓库
2. 创建你的功能分支：

git checkout -b feature/amazing-feature

3. 提交更改：

git commit -m '添加了惊人的功能'

4. 推送到分支：

git push origin feature/amazing-feature

5. 打开拉取请求

添加新的 MCP 服务器

在 registry/servers.yaml 中添加你的服务器：

- name: "您的 MCP 服务器"
  description: "服务器描述"
  runtime: "node"  # 或 "python"
  package: "your-package-name"
  version: "1.0.0"
  command_args:
    - "your-command-args"
  env:
    YOUR_ENV_VAR: ""

📝 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件以获取详细信息。

🔗 链接

• 文档
• 问题跟踪器
• 模型上下文协议

---

<div align="center"> 由 MCPHub 社区制作 ❤️ </div>