mcp助手
一个用于管理MCP（模型上下文协议）服务器的综合工具包，提供独立的CLI工具和未来的Claude Code斜线命令集成。
🎯 概述
mcp-helper简化了mcp服务器的全局和每个项目的发现、安装、配置和管理。它提供：
- 独立CLI工具 (✅ 已实现）：用于管理Claude Code之外的MCP服务器的命令行界面
- Claude代码Slash命令 (🚧 计划中）：用于Claude Code聊天界面的原生斜线命令
📁 项目结构
mcp-helper/
├── cli/ # Standalone CLI implementation
│ ├── base-command.js # Base command class with shared functionality
│ ├── router.js # Command router and dispatcher
│ └── commands/ # Individual command implementations
├── slash-commands/ # Future Claude Code slash commands (planned)
├── lib/ # Shared libraries
│ ├── config-manager.js # Configuration management
│ ├── server-cards.js # Server card operations
│ └── claude-md-generator.js # CLAUDE.md generation
├── catalog/ # Server configurations
│ ├── server_cards/ # Individual server card JSON files
│ └── minimum_servers.json # Foundation servers for custom support
├── schemas/ # JSON schemas for validation
├── templates/ # Configuration templates
└── test/ # Test suites
└── e2e/ # End-to-end tests🚀 安装
作为全球CLI工具
# Clone the repository
git clone https://github.com/YOUR_USERNAME/mcp-helper.git
cd mcp-helper
# Install dependencies
npm install
# Link globally (optional)
npm link为了发展
# Install dependencies
npm install
# Run tests
npm test
# Run specific command
node bin/mcp-helper [options]💻 CLI使用情况
独立CLI工具提供以下命令：
初始化项目
mcp-helper init为您的项目设置MCP配置，检测环境，并创建必要的文件。
添加服务器
mcp-helper add 从目录中交互式配置和添加MCP服务器。
添加自定义服务器
mcp-helper add-custom添加不在预定义目录中的自定义MCP服务器。
列出服务器
mcp-helper list显示所有已配置的服务器及其状态和评级。
重新配置服务器
mcp-helper reconfigure 修改现有服务器的配置。
获得帮助
mcp-helper help显示可用命令和使用信息。
🔮 Claude Code Slash命令（计划中）
未来的集成将允许在Claude Code中直接使用这些命令：
/mcp-helper init
/mcp-helper add github
/mcp-helper list
/mcp-helper reconfigure serena
/mcp-helper add-custom这些将在Claude Code聊天界面中本地工作，提供无缝的MCP服务器管理，而无需离开您的对话。
🧪 测试
# Run all tests
npm test
# Run e2e tests specifically
node test/e2e/test-runner.js📊 服务器评级
每个MCP服务器都有两个评级：
- 人类评级（1-5）：对人类监督和验证的有用性
- AI代理评级（1-5）：自主AI开发任务的重要性
🏗️ 体系结构决策
双模式操作
- 命令行接口命令模式：用于终端使用的独立工具
- Slash命令模式：Claude Code聊天界面的未来集成
命令模式
- 基本命令类提供共享功能
- 指挥调度路由器模式
- 颜色编码输出，提供更好的用户体验
- 交互式配置提示
配置管理
- 全局配置
~/.claude.json - 中的项目特定覆盖
.env - 用于安全的环境变量占位符
🤝 贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 进行更改
- 如果适用，添加测试
- 提交拉取请求
📄 许可证
麻省理工学院