MCP服务器生命周期管理工具

MCP Developer Toolkit 是一个专为MCP服务器设计的生命周期管理工具,提供从创建、部署到测试的全流程自动化支持,适用于需要管理多个MCP服务器的开发环境。

  • by donshults
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 donshults/mcp-developer-toolkit

使用说明

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 <name> --repo <url> -创建新的MCP服务器
  • mcp-dev list -显示所有托管服务器
  • mcp-dev start <name|all> -启动服务器
  • mcp-dev stop <name|all> -停止服务器
  • mcp-dev restart <name> -重新启动服务器
  • mcp-dev status -显示运行状态
  • mcp-dev remove <name> -完全删除服务器

发展

  • mcp-dev update <name> -Git拉取最新更改
  • mcp-dev install <name> -安装/更新要求
  • mcp-dev logs <name> -尾部服务器日志
  • mcp-dev shell <name> -进入服务器的Python环境

测试

  • mcp-dev health <name> -测试健康终点
  • mcp-dev test-config <name> -验证配置
  • mcp-dev connect <name> -测试MCP连接

社区与支持

贡献

我们欢迎捐款!看 贡献.md 作为指导方针。

快速帮助方式:

  • ⭐ 为存储库添加星号
  • 🐛 报告错误和问题
  • 💡 建议功能
  • 🔧 提交拉取请求
  • 📖 改进文档
  • 🧪 使用您的MCP服务器进行测试

获取帮助

  • 问题: GitHub 问题 用于错误和功能请求
  • 讨论:使用GitHub讨论提问
  • 标准问题:使用“存储库标准问题”问题模板

存储库标准采用

帮助建立 /mcp-server/ 作为生态系统标准:

  1. 使用标准 在MCP服务器存储库中
  2. 分享反馈 论什么有效/什么无效
  3. 传话 其他MCP开发人员
  4. 提供示例 结构良好的MCP存储库

路线图

  • [ ] 虚拟环境支持 -每个MCP服务器完全隔离
  • [ ] 健康检查增强功能 -更好的连接性测试
  • [ ] Windows支持 -跨平台兼容性
  • [ ] VSCode扩展 -MCP开发的IDE集成
  • [ ] Web仪表板 -用于管理MCP服务器的GUI
  • [ ] 包装分发 -PyPI/NMP包,安装更简单

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。