MCP开发工具包
MCP服务器的专业生命周期管理 -从设置到部署再到测试。
MCP开发中的问题
当前的MCP服务器开发很痛苦:
- ❌ 在存储库和客户端计算机之间手动复制文件
- ❌ 管理每台服务器的Python环境
- ❌ 在任务管理器中查找崩溃的进程
- ❌ 没有标准化的方法来组织存储库中的MCP服务器代码
- ❌ MCP服务器更改时的复杂更新工作流程
- ❌ 不同MCP服务器之间没有隔离
解决方案
一个工具包来管理所有这些:
# Create clean MCP server from any repo
mcp-dev create tastytrade --repo https://github.com/company/tastytrade-integration.git
# Professional management
mcp-dev start tastytrade
mcp-dev update tastytrade # git pull + restart
mcp-dev health tastytrade # test connectivity
mcp-dev list # show all servers存储库标准
该工具包建立了一个 标准惯例 对于MCP服务器分发:
your-saas-project/
├── src/ # Your main application
├── api/ # Your web API
├── docs/
└── mcp-server/ # 🎯 STANDARD: MCP client files here
├── server.py
├── requirements.txt
├── .env.example
└── README.md优点:
- ✅ 可预测的 -开发人员总是知道在哪里可以找到MCP服务器代码
- ✅ 工具包友好 -自动检测功能开箱即用
- ✅ 清洁分离 -MCP代码与主应用程序隔离
- ✅ 生态系统标准 -每个人都遵循同样的模式
特性
🚀 服务器生命周期
- 从任何Git存储库创建新的MCP服务器
- 自动Python虚拟环境设置
- 需求安装和依赖关系管理
- 流程管理(启动/停止/重启/状态)
🔍 开发工具
- 健康检查验证(
/health端点测试) - 日志跟踪和调试
- 配置验证
- 连接性测试
🛠️ 环境管理
- 每台服务器的独立Python环境
- 自动处理requirements.txt
- 环境变量管理(.env文件)
- 清洁流程清理(不再有任务管理器!)
📦 多服务器支持
- 管理无限制的MCP服务器
- 每台服务器有不同的存储库
- 独立的配置和环境
- 批量操作(启动/停止所有)
快速开始
安装
# Clone and install
git clone https://github.com/donshults/mcp-developer-toolkit.git
cd mcp-developer-toolkit
sudo ./install.sh基本用法
# Create MCP server from standardized repo (auto-detects /mcp-server/)
mcp-dev create my-server --repo https://github.com/user/project.git
# Or for legacy/custom structure
mcp-dev create my-server --repo URL --subfolder custom_folder
# Manage your MCP servers
mcp-dev start my-server # Start the server
mcp-dev list # Show all servers
mcp-dev update my-server # Git pull + restart
mcp-dev health my-server # Test connectivity
mcp-dev stop my-server # Clean shutdown真实示例-上下文保险库
# Context Vault uses legacy structure (mcp_server folder)
mcp-dev create context-vault \
--repo https://github.com/donshults/ThisIsDonsBrain.git \
--subfolder mcp_server
# Start and verify
mcp-dev start context-vault
mcp-dev status # Check if running用例
上下文库开发
# Set up Context Vault MCP server
mcp-dev create context-vault --repo https://github.com/donshults/ThisIsDonsBrain.git --path server.py
# Update with latest changes
mcp-dev update context-vault
# Test it's working
mcp-dev health context-vault多个MCP服务器
# Different MCP servers for different purposes
mcp-dev create context-vault --repo https://github.com/donshults/ThisIsDonsBrain.git
mcp-dev create file-manager --repo https://github.com/user/file-mcp.git
mcp-dev create database-tool --repo https://github.com/user/db-mcp.git
# Manage them all
mcp-dev list
mcp-dev start all
mcp-dev status建筑
MCP Developer Toolkit
├── Server Registry (tracks all MCP servers)
├── Environment Manager (Python venvs per server)
├── Process Manager (start/stop/restart)
├── Health Monitor (connectivity testing)
├── Update Manager (git pull + restart)
└── Configuration Manager (.env, configs)命令参考
服务器管理
mcp-dev create --repo-创建新的MCP服务器mcp-dev list-显示所有托管服务器mcp-dev start-启动服务器mcp-dev stop-停止服务器mcp-dev restart-重新启动服务器mcp-dev status-显示运行状态mcp-dev remove-完全删除服务器
发展
mcp-dev update-Git拉取最新更改mcp-dev install-安装/更新要求mcp-dev logs-尾部服务器日志mcp-dev shell-进入服务器的Python环境
测试
mcp-dev health-测试健康终点mcp-dev test-config-验证配置mcp-dev connect-测试MCP连接
社区与支持
贡献
我们欢迎捐款!看 贡献.md 作为指导方针。
快速帮助方式:
- ⭐ 为存储库添加星号
- 🐛 报告错误和问题
- 💡 建议功能
- 🔧 提交拉取请求
- 📖 改进文档
- 🧪 使用您的MCP服务器进行测试
获取帮助
- 问题: 用于错误和功能请求
- 讨论:使用GitHub讨论提问
- 标准问题:使用“存储库标准问题”问题模板
存储库标准采用
帮助建立 /mcp-server/ 作为生态系统标准:
- 使用标准 在MCP服务器存储库中
- 分享反馈 论什么有效/什么无效
- 传话 其他MCP开发人员
- 提供示例 结构良好的MCP存储库
路线图
- \[ \] 虚拟环境支持 -每个MCP服务器完全隔离
- \[ \] 健康检查增强功能 -更好的连接性测试
- \[ \] Windows支持 -跨平台兼容性
- \[ \] VSCode扩展 -MCP开发的IDE集成
- \[ \] Web仪表板 -用于管理MCP服务器的GUI
- \[ \] 包装分发 -PyPI/NMP包,安装更简单
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
