Xiaotian MCP Manager

🚀 MCP Manager

强大的 Model Context Protocol 服务统一管理工具

 ](https://github.com/tianhaonan/xiaotian-mcp-manager/releases)  ](https://nodejs.org) 

功能特性 • 快速开始 • 服务市场 • 配置模板 • 命令参考

📖 简介

MCP Manager 是一个功能强大的命令行工具，专为管理 Model Context Protocol (MCP) 服务器而设计。它提供了完整的服务市场、智能安装系统和配置模板，让您轻松管理 19+ 精选 MCP 服务。

为什么选择 MCP Manager?

✨ 功能特性

核心功能

• ✅ 服务市场浏览 - 按分类浏览 19+ 精选 MCP 服务
• 🔍 关键词搜索 - 快速查找所需服务
• 📖 详细服务介绍 - 完整的中文功能描述、使用场景和配置指南
• 🎯 配置模板 - 面向前端、后端、测试、全栈、AI 研究的预设模板
• 🤖 智能安装 - 从 npm 搜索、验证并安装自定义服务

管理功能

• 📦 安装/更新/卸载服务（支持全部 19 个服务）
• 🔍 服务状态查看和健康检查
• 📊 版本管理和更新提醒
• 💾 配置备份和恢复
• 📝 日志查看和清理

📋 系统要求

安装依赖

# macOS
brew install jq node

# Ubuntu/Debian
sudo apt-get install jq nodejs npm

🚀 快速开始

1. 克隆仓库

git clone https://github.com/tianhaonan/xiaotian-mcp-manager.git
cd xiaotian-mcp-manager

2. 添加执行权限

chmod +x mcp-manager.sh

3. 运行管理器

# 启动交互式菜单
./mcp-manager.sh

# 或直接安装所有服务
./mcp-manager.sh install

📚 使用指南

交互式菜单

运行 ./mcp-manager.sh 进入主菜单:

╔════════════════════════════════════════════════════════╗
║          MCP 服务管理器 v1.0.0                         ║
╚════════════════════════════════════════════════════════╝

当前 MCP 服务状态:
─────────────────────────────────────────
  ✅ Sequential Thinking (全局)
  ✅ Memory (全局)
  ✅ Context7 (全局)
  ... (共 15 个已安装)
─────────────────────────────────────────
Registry 定义: 19 个服务
全局安装: 15 个 | npx 运行: 0 个 | 总计: 15

请选择操作:
  1) 🛒 浏览 MCP 服务市场
  2) 📦 配置模板市场
  3) 安装全部 MCP 服务
  4) 安装指定服务
  5) 更新已安装服务
  6) 卸载服务
  7) 添加自定义服务 (智能搜索)
  ...

🛒 服务市场

MCP Manager 精选了 19 个高质量 MCP 服务，按功能分类:

🤖 AI 工具 (3个)

💻 开发工具 (2个)

🗄️ 数据库 (3个)

🎨 前端开发 (5个)

🔍 搜索工具 (2个)

🔧 工作流工具 (4个)

🎯 配置模板

快速部署预设场景的工具组合:

🎨 前端开发者

包含服务: Playwright + MarkItDown + Vue MCP + Chrome DevTools + Sequential Thinking

适用场景: Vue/React 开发、组件调试、文档编写、E2E 测试

./mcp-manager.sh templates
# 选择 1) 前端开发者

🔧 后端开发者

包含服务: PostgreSQL + MongoDB + Filesystem + Fetch + Sequential Thinking

适用场景: API 开发、数据库操作、数据爬取、系统设计

🧪 测试工程师

包含服务: Playwright + Chrome DevTools + GitHub + Sequential Thinking

适用场景: E2E 测试、性能测试、错误追踪、测试报告

🖥️ 全栈开发者

包含服务: GitHub + PostgreSQL + Playwright + Sequential Thinking + Memory

适用场景: 全栈开发、代码管理、数据库设计、自动化测试

🤖 AI 研究者

包含服务: Sequential Thinking + Memory + Context7 + Fetch + GitHub

适用场景: 技术研究、知识管理、文档分析、实验记录

⌨️ 命令参考

服务市场

./mcp-manager.sh market              # 浏览服务市场
./mcp-manager.sh search       # 搜索服务
./mcp-manager.sh templates           # 查看配置模板
./mcp-manager.sh info        # 查看服务详情

服务管理

./mcp-manager.sh list                # 查看已安装服务状态
./mcp-manager.sh install             # 安装全部服务
./mcp-manager.sh install    # 安装指定服务
./mcp-manager.sh update              # 更新所有已安装服务
./mcp-manager.sh uninstall     # 卸载指定服务
./mcp-manager.sh uninstall all       # 卸载全部服务

自定义服务

./mcp-manager.sh add-custom          # 智能搜索添加自定义服务

工具命令

./mcp-manager.sh check               # 健康检查
./mcp-manager.sh versions            # 版本信息
./mcp-manager.sh logs                # 查看日志
./mcp-manager.sh clean               # 清理日志
./mcp-manager.sh backup              # 备份配置
./mcp-manager.sh restore             # 恢复配置
./mcp-manager.sh help                # 显示帮助

包管理器切换

# 临时使用 npm
PACKAGE_MANAGER=npm ./mcp-manager.sh install

# 永久切换 (编辑脚本第 29 行)
PACKAGE_MANAGER="npm"

🛠️ 高级配置

自定义服务注册表

编辑 mcp-registry.json 添加自定义服务:

{
  "id": "your-service",
  "name": "Your Service Name",
  "package": "npm-package-name",
  "exe": "executable-name",
  "categories": ["frontend", "backend"],
  "popularity": 4,
  "official": false,
  "description": {
    "en": "English description",
    "zh": "中文描述"
  },
  "features": ["特性1", "特性2"],
  "useCases": ["场景1", "场景2"],
  "requiresConfig": false
}

服务分类

🔍 故障排除

常见问题

Q: 安装服务时提示 "包不存在"

某些官方服务包已从 npm registry 移除（如 Git、SQLite、Fetch），可以使用 npx 方式运行:

claude mcp add git npx -y @modelcontextprotocol/server-git

Q: 如何查看服务是否正常运行?

./mcp-manager.sh check    # 运行健康检查
claude mcp list           # 查看 Claude 中注册的服务

Q: 如何切换包管理器?

# 方式 1: 环境变量
export PACKAGE_MANAGER=npm

# 方式 2: 编辑脚本第 29 行
PACKAGE_MANAGER="npm"

Q: 卸载服务后如何清理配置?

./mcp-manager.sh clean    # 清理日志
rm -rf ~/.cache/claude-cli-nodejs/  # 清理缓存

🤝 贡献指南

欢迎贡献代码、文档或新的 MCP 服务!

如何贡献

1. Fork 本仓库
2. 创建功能分支: git checkout -b feature/amazing-feature
3. 提交更改: git commit -m 'feat: 添加某个功能'
4. 推送分支: git push origin feature/amazing-feature
5. 提交 Pull Request

添加新服务

1. 在 mcp-registry.json 中添加服务信息
2. 包含完整的中文描述和使用场景
3. 验证服务可以正常安装和运行
4. 提交 PR 并说明服务的用途

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

• Anthropic - Model Context Protocol 规范制定
• Microsoft - Playwright 和 MarkItDown 官方支持
• MCP 社区 - 所有优秀的 MCP 服务器开发者

相关资源

• 📖 Model Context Protocol 官方文档
• 🔧 Claude CLI 文档
• 🌟 MCP 服务器集合

🎉 享受使用 MCP Manager!

Made with ❤️ by the MCP Manager Team

⬆ 回到顶部