MCP Gearbox

一款现代桌面应用程序，用于跨多个AI代理管理模型上下文协议（MCP）服务器。

📸 截图

📚 文档

如需详细了解使用说明，请访问我们的文档。

🤔 MCP Gearbox 是什么？

MCP Gearbox 是一个强大的跨平台桌面应用，简化了对AI代理（如Claude、Kiro、Continue、Copilot、Cursor、Qoder等）的MCP服务器管理。该生产力工具使用Electron、React和TypeScript构建，提供直观界面来发现、安装、配置和管理MCP服务器，无需手动编辑配置文件。无论你是开发者、研究人员还是AI爱好者，MCP Gearbox都能通过本地AI集成和服务器管理功能简化你的工作流程。

主要特性

作为AI开发前沿的生产力工具，MCP Gearbox 提供：

• 🔍 服务器发现 - 浏览并搜索社区提供的可用MCP服务器
• ⚡ 一键安装 - 单击即可将MCP服务器安装到AI代理中
• 🎛️ 多代理支持 - 从一个界面管理多个AI代理的服务器
• 📊 服务器管理 - 轻松启用、禁用和移除服务器
• 🔧 配置轻松化 - 不需要手动编辑JSON配置文件
• 🎨 现代UI - 使用shadcn/ui组件和Tailwind CSS构建，带来美观体验
• 💾 状态持久性 - 自动保存设置和偏好

这些特性使MCP Gearbox成为与AI助手合作的开发者的终极生产力工具。

💡 为什么选择 MCP Gearbox？

手动管理MCP服务器既繁琐又容易出错。MCP Gearbox通过提供一个代码助手生产力工具来消除复杂性：

• 提供服务器管理的可视化界面
• 自动更新配置文件
• 提供服务器发现和推荐
• 支持在一个地方管理多个AI代理
• 将设置时间从几分钟缩短到几秒钟

这个AI集成工具改变了开发者和研究人员如何与模型上下文协议服务器交互，使得本地AI设置变得轻松高效。

💻 安装

几分钟内开始使用这个AI集成工具。MCP Gearbox 支持所有主要操作系统。

🔧 要求

• uv 用于包管理
• Python 3.11+
• Git

下载

立即开始使用我们预构建的二进制文件以获得最大便利：

• Windows: mcp-gearbox-setup.exe
• macOS: mcp-gearbox.dmg
• Linux: mcp-gearbox.deb 或 mcp-gearbox.rpm

这个跨平台的AI集成工具已准备好提升你的生产力工作流。

🛠️ 从源码构建

从源码构建此生产力工具，以根据具体需求进行定制：

# 克隆仓库
git clone https://github.com/rohitsoni007/mcp-gearbox.git
cd mcp-gearbox

# 安装依赖
npm install

# 开发模式运行
npm start

# 生产环境构建
npm run make

从源码构建提供了扩展MCP Gearbox作为AI集成工具的灵活性。

🎯 使用

通过以下简单步骤解锁此生产力工具的全部潜力：

🚀 快速入门

1. 启动 MCP Gearbox - 打开应用程序
2. 检查代理状态 - 查看哪些AI代理已安装和配置
3. 浏览服务器 - 探索可用的MCP服务器
4. 安装服务器 - 点击添加服务器到首选代理
5. 管理配置 - 根据需要启用或禁用服务器

这种直观的工作流程让管理AI助手变得轻松。

🖥️ 服务器管理

轻松控制你的AI助手生态系统，利用这些管理功能：

• 添加服务器：浏览服务器列表并点击“安装”任何服务器
• 移除服务器：导航到已安装的服务器并点击“移除”
• 启用/禁用：切换服务器开关而不卸载

这种服务器管理能力使MCP Gearbox成为AI开发的终极生产力工具。

🤖 支持的AI代理

MCP Gearbox无缝集成流行的AI代码助手和开发工具：

代理	支持	备注
GitHub Copilot	✅
Continue	✅
Kiro	✅
Cursor	✅
Claude Code	✅
Gemini CLI	✅
Qoder	✅
Copilot CLI	✅
LM Studio	✅
Google Antigravity	✅

⚙️ 技术栈

• 框架：Electron 39 与 Electron Forge
• 前端：React 19 与 TypeScript
• 路由：TanStack Router
• 状态管理：Redux Toolkit 与 Redux Persist
• UI 组件：shadcn/ui 与 Radix UI 原语
• 样式：Tailwind CSS 4
• 构建工具：Vite (Rollup)
• 测试：Vitest + Playwright

开发

加入我们，共同改进这个面向开发者的AI集成工具。我们采用现代开发实践确保代码质量和可维护性。

📁 项目结构

我们的代码库遵循现代开发实践，易于理解并扩展：

mcp-gearbox/
├── src/
│   ├── components/     # React 组件
│   ├── hooks/          # 自定义 React 钩子
│   ├── pages/          # 页面组件
│   ├── services/       # API 和服务层
│   ├── store/          # Redux 存储和切片
│   ├── types/          # TypeScript 类型定义
│   ├── utils/          # 工具函数
│   ├── main.ts         # Electron 主进程
│   ├── preload.ts      # Electron 预加载脚本
│   └── renderer.tsx    # React 渲染器入口
├── tests/              # E2E 测试
└── forge.config.ts     # Electron Forge 配置

这种模块化结构使MCP Gearbox易于理解和扩展。

📜 可用脚本

通过这些npm脚本简化开发工作流：

npm start              # 启动开发服务器
npm run build          # 构建生产环境
npm run make           # 创建可分发的包
npm run lint           # 运行 ESLint
npm run format         # 使用 Prettier 格式化代码
npm test               # 运行单元测试
npm run test:e2e       # 运行端到端测试

这些脚本确保一致的开发实践，便于贡献到这个生产力工具。

🧪 测试

我们通过全面测试维持高质量标准：

# 使用 Vitest 进行单元测试
npm test
npm run test:watch
npm run test:coverage

# 使用 Playwright 进行端到端测试
npm run test:e2e
npm run test:e2e:ui

我们的测试方法确保MCP Gearbox作为一个可靠的AI集成工具。

我们遵循最佳实践进行测试，确保MCP Gearbox保持可靠。

🤝 贡献

我们欢迎来自AI开发社区的贡献！无论是经验丰富的开发者还是新接触AI工具的人，您的意见有助于使MCP Gearbox更好。请参阅我们的CONTRIBUTING.md了解详情：

• 行为准则
• 开发环境设置
• 提交拉取请求
• 报告问题
• 编码标准

加入我们，一起打造终极的AI助手管理生产力工具。

📄 许可证

此开源生产力工具在MIT许可下发布 - 详情见LICENSE文件。MIT许可允许您使用、修改和分发MCP Gearbox，适用于个人和商业项目。

💬 支持

需要帮助或有关于管理MCP服务器的问题？我们在这里为您提供帮助：

• 问题：GitHub Issues - 报告错误或请求功能
• 讨论：GitHub Discussions - 提问并与其他用户交流

作为AI开发者的生产力工具，我们致力于为社区提供卓越的支持。

🗺️ 发展路线图

我们未来计划增强此AI集成工具包括：

• 服务器配置编辑器
• 自定义服务器添加
• 服务器健康监控
• 备份和恢复配置
• 深色/浅色主题切换
• 多语言支持

🙏 致谢

该项目基于Model Context Protocol Servers和GitHub MCP Registry的数据，并使用了我的另一个项目MCP-Gearbox-CLI。

我们持续努力提高MCP Gearbox作为AI开发社区生产力工具的功能。

---

关键词：MCP, 模型上下文协议, AI代理, Claude桌面, Kiro, Electron应用, 服务器管理, AI工具, 桌面应用, TypeScript, React, MCP服务器, AI配置, 开发者工具, AI助手, 本地AI, MCP客户端, AI集成, 代码助手, 生产力工具, 跨平台应用