🚀 MCP Manager

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

📖 简介

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

为什么选择 MCP Manager?

| 特性 | 说明 | |------|------| | 🎯 精选服务库 | 19 个经过筛选的高质量 MCP 服务 | | 🌏 完整中文支持 | 详细的中文服务介绍、使用场景和配置说明 | | 📦 智能分类 | 前端、后端、测试三大类别，快速定位所需工具 | | 🔧 配置模板 | 5 个预设角色模板，一键部署工具链 | | 🔍 智能搜索 | 从 npm 搜索、验证并安装自定义 MCP 服务 | | ⚙️ 灵活配置 | 支持 npm 和 pnpm 双包管理器 | | 🚀 性能优化 | 缓存机制，快速响应 |

✨ 功能特性

核心功能

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

管理功能

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

📋 系统要求

| 依赖项 | 版本要求 | 说明 | |--------|---------|------| | 操作系统 | macOS / Linux | Windows 请使用 WSL | | Node.js | >= 18.0 | 下载安装 | | Claude CLI | 最新版 | 安装指南 | | jq | 最新版 | JSON 解析工具(推荐) | | npm/pnpm | 最新版 | 包管理器(二选一) |

安装依赖

# 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个)

| 服务 | 热度 | 官方 | 功能 | |------|------|------|------| | Sequential Thinking | ⭐⭐⭐⭐⭐ | ✓ | 动态反思式问题解决，多步推理，复杂任务分解 | | Memory | ⭐⭐⭐⭐⭐ | ✓ | 知识图谱记忆系统，上下文持久化 | | Context7 | ⭐⭐⭐⭐ | | 实时技术文档上下文，最新 API 参考 |

💻 开发工具 (2个)

| 服务 | 热度 | 官方 | 功能 | |------|------|------|------| | GitHub | ⭐⭐⭐⭐⭐ | ✓ | GitHub 仓库、Issue、PR 管理 | | Filesystem | ⭐⭐⭐⭐⭐ | ✓ | 安全的文件系统操作 |

🗄️ 数据库 (3个)

| 服务 | 热度 | 官方 | 功能 | |------|------|------|------| | PostgreSQL | ⭐⭐⭐⭐ | ✓ | 数据库只读访问和查询 | | SQLite | ⭐⭐⭐ | ✓ | 轻量级嵌入式数据库 | | MongoDB | ⭐⭐⭐ | | NoSQL 文档数据库，Atlas 云支持 |

🎨 前端开发 (5个)

| 服务 | 热度 | 官方 | 功能 | |------|------|------|------| | Playwright | ⭐⭐⭐⭐⭐ | ✓ | Microsoft 官方浏览器自动化 | | Chrome DevTools | ⭐⭐⭐ | | Chrome 调试工具集成 | | MarkItDown | ⭐⭐⭐⭐ | ✓ | Microsoft 官方 Markdown 文档处理 | | Vue MCP | ⭐⭐⭐ | | Vue.js 项目辅助开发 | | Fetch | ⭐⭐⭐⭐ | ✓ | 网页内容获取和抓取 |

🔍 搜索工具 (2个)

| 服务 | 热度 | 官方 | 功能 | |------|------|------|------| | Brave Search | ⭐⭐⭐⭐ | ✓ | 隐私友好的网络搜索 | | Open WebSearch | ⭐⭐⭐ | | 多引擎搜索 (DuckDuckGo/Bing/Brave) |

🔧 工作流工具 (4个)

| 服务 | 热度 | 官方 | 功能 | |------|------|------|------| | Spec Workflow | ⭐⭐⭐⭐ | | 规范驱动开发流程，实时 Web 仪表板 | | DeepWiki | ⭐⭐⭐ | | 技术文档聚合，GitHub 仓库文档提取 | | Shrimp Task Manager | ⭐⭐⭐⭐ | | 智能任务规划与管理，多步骤分解 | | Git | ⭐⭐⭐⭐ | ✓ | Git 仓库操作和版本控制 |

🎯 配置模板

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

🎨 前端开发者

包含服务: 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 <服务ID>       # 查看服务详情

服务管理

./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
}

服务分类

| 分类 | ID | 说明 | |------|-----|------| | 🎨 前端 | frontend | 前端开发、浏览器自动化、UI 测试 | | 🔧 后端 | backend | 后端开发、数据库、API 开发 | | 🧪 测试 | testing | 自动化测试、E2E 测试、性能测试 |

🔍 故障排除

常见问题

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 服务!

如何贡献

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

添加新服务

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

📄 许可证

本项目采用 MIT 许可证。

🙏 致谢

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