mcp-man 及 MCP 服务器管理工具试用报告

Codex 核验（2026-10-09）：本文是当时测试记录，未重新安装或重启服务。GitHub 的旧 @modelcontextprotocol/server-github 包应按官方 github-mcp-server部署说明选当前传输和认证方式。当前本机 Hermes 帮助显示服务管理命令为 hermes gateway restart；原 hermes restart 不是该命令。Mac 本地保存配置不代表远端 MCP/LLM 处理的数据也留本地；原日期目录能力差异不作为当前支持结论。

报告日期: 2026-05-28

目录

1. 概述
2. 工具一：mcp-man (aaglexx/mcp-man)
3. 工具二：mcpm.sh (pathintegral-institute/mcpm.sh)
4. 工具三：nstebbins/mcp-manager
5. 工具四：amxv/mcp-manager (Web UI)
6. Hermes 原生 MCP 集成
7. 对比评估
8. 安装配置方案
9. 对 Hermes MCP 管理的实用性评估
10. 总结与建议

概述

本报告评估了多个 MCP (Model Context Protocol) 服务器管理工具，重点关注其对 Hermes Agent MCP 管理的实用性。

主要评估工具：

工具一：mcp-man (aaglexx/mcp-man)

基本信息

• GitHub: aaglexx/mcp-man
• Star: 12（较新项目，2026-05-20 创建）
• 许可证: MIT
• 语言: TypeScript
• 安装: npm install -g @aaglexx/mcp-man
• 描述: “Postman for MCP servers — inspect tools, test live, browse 150+ servers”

核心功能

实际测试结果

1. 搜索功能

$ mcp-man search github
3 server(s) found:
  github-mcp-server — Official GitHub MCP server — 26+ tools
  github-mcp-server — Official GitHub MCP server — full GitHub API with 80+ tools
  mcp-server-github-actions — Trigger and monitor GitHub Actions workflows

2. 检查功能 - memory 服务器

$ mcp-man inspect "npx -y @modelcontextprotocol/server-memory"
✔ Connected
🔧 Tools (9)
  create_entities
  create_relations
  add_observations
  delete_entities
  delete_observations
  delete_relations
  read_graph
  search_nodes
  open_nodes

3. 测试功能

$ mcp-man test read_graph \
  --server "npx -y @modelcontextprotocol/server-memory"
✔ Tool "read_graph" responded
{"entities": [], "relations": []}
 
$ mcp-man test create_entities \
  '{"entities":[{"name":"TestEntity","entityType":"test","observations":["test"]}]}' \
  --server "npx -y @modelcontextprotocol/server-memory"
✔ Tool "create_entities" responded
[{"name": "TestEntity", ...}]

4. Web UI

$ mcp-man ui
mcp-man API → http://${LOCALIP}:7070
Web UI      → http://${LOCALIP}:4242

优缺点

优点:

• 工具范式清晰：search → inspect → test，像 Postman 之于 REST API
• 无需 Auth 即可浏览 156 个预注册服务器
• Web UI 方便非技术用户
• CLI 输出清晰友好
• MIT 许可证

缺点:

• ⭐12，非常新，社区和成熟度有限
• 只支持 stdio 协议的服务器（不支持 HTTP MCP）
• 不具备安装/配置管理功能——只是浏览器/调试器
• 没有与 MCP client 配置集成
• Registry 是静态 JSON 文件，通过 PR 提交

工具二：mcpm.sh (pathintegral-institute/mcpm.sh)

基本信息

• GitHub: pathintegral-institute/mcpm.sh
• Star: ⭐954
• 许可证: MIT
• 语言: Python
• 版本: v2.15.0
• 安装: curl -sSL https://mcpm.sh/install | bash 或 pipx install mcpm
• 描述: “CLI MCP package manager & registry for all platforms and all clients”

核心功能

优缺点

优点:

• 最完整的 MCP 管理 CLI（≈954⭐，社区成熟）
• 全局服务器管理 + Profile 组织
• 多客户端集成（Claude Desktop, Cursor, Windsurf 等）
• 支持 stdio / HTTP / SSE 传输协议
• 服务器分享（tunnel）、使用监控
• 持续更新活跃
• 中英文文档齐全

缺点:

• 安装需 pip / pipx / Homebrew，依赖 Python 环境
• CLI 启动时 banner + deprecation warning 较慢
• 对 Hermes 没有原生支持（但可以生成 stdio 配置）
• Python 3.12 debian 系统需额外安装 pipx/venv

工具三：nstebbins/mcp-manager

基本信息

• GitHub: nstebbins/mcp-manager
• Star: ⭐25
• 许可证: GPL-3.0
• 语言: Python
• 版本: 0.2.6
• 安装: pip install mcp-manager
• 描述: “CLI tool for managing MCP servers in one place & using them across different clients”

核心功能

支持客户端: Claude Desktop, Cursor, Claude Code

优缺点

优点:

• 简洁的跨客户端管理
• 自动依赖检查

缺点:

• ⭐25，社区较小
• 当前仅支持 6 个预定义服务器（Playwright, Filesystem, Fetch, Git, GitHub, Memory）
• 支持客户端有限（Hermes 不在其中）
• GPL-3.0 许可证

工具四：amxv/mcp-manager (Web UI)

基本信息

• GitHub: amxv/mcp-manager
• Star: ⭐288
• 语言: TypeScript (React + Vite + TailwindCSS)
• 安装: git clone && npm install && npm run dev
• 描述: “Simple web GUI to manage MCP servers in the Claude Desktop app”

核心功能

• 图形化添加/移除 MCP 服务器
• 支持 22+ 个流行 MCP 服务器的快速配置
• 一键复制安装命令
• 环境变量配置
• 仅客户端运行，数据不出机器
• 专为 macOS Claude Desktop 应用设计

优缺点

优点:

• 漂亮的 UI 设计（仿 Anthropic 设计语言）
• 快速上手，适合新手
• 纯客户端（隐私友好）

缺点:

• 仅适用于 macOS Claude Desktop
• 不跨平台（无 Linux/Windows 支持）
• 对 Hermes 不兼容
• React 项目，需本地开发环境运行

Hermes 原生 MCP 集成

Hermes Agent 已内置完整的 Native MCP Client（native-mcp skill）：

配置方式

# ~/.hermes/config.yaml
mcp_servers:
  time:
    command: "uvx"
    args: ["mcp-server-time"]
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
  github:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

Hermes 原生特性

• 启动时自动发现并注册 MCP 工具
• 工具命名: mcp_{server_name}_{tool_name}
• 支持 stdio 和 HTTP/StreamableHTTP 两种传输
• 自动注入所有平台工具集（CLI, Discord, Telegram 等）
• 长连接管理 + 自动重连（指数退避）
• 环境变量安全过滤
• 错误信息凭证脱敏
• 支持 MCP Sampling（服务器请求 LLM 补全）

对比评估

安装配置方案

推荐安装

# 1. mcp-man — 用于快速检查/调试 MCP 服务器
npm install -g @aaglexx/mcp-man
 
# 2. mcpm.sh — 用于搜索和管理 MCP 服务器包
pipx install mcpm
 
# 3. Hermes MCP 配置 — 直接在 config.yaml 中配置
# 编辑 ~/.hermes/config.yaml 添加 mcp_servers

建立连接：mcp-man → Hermes

mcp-man 不能直接管理 Hermes 的配置，但可以这样配合：

1. 用 mcpm 搜索并安装服务器:

   mcpm search filesystem
   mcpm install filesystem
   mcpm ls  # 获取安装信息

2. 用 mcp-man 检查/测试服务器:

   mcp-man inspect "npx -y @modelcontextprotocol/server-filesystem /path"
   mcp-man test read_file --server "npx -y @modelcontextprotocol/server-filesystem /path"

3. 将配置写入 Hermes config.yaml:

   # 从 mcpm info 或 mcp-man inspect 获取命令，手动添加到
   # ~/.hermes/config.yaml 的 mcp_servers 下

工作流建议

mcpm search firebase         # 1. 发现可用服务器
mcpm info firebase           # 2. 查看详情
mcp-man inspect "npx ..."    # 3. 检查工具接口
mcp-man test ...             # 4. 测试工具调用
# 确认后 → 写入 Hermes config.yaml
hermes gateway restart               # 5. 启动集成

对 Hermes MCP 管理的实用性评估

1. mcp-man — 作为 MCP 探索/调试工具

非常有价值 ✅

• 在将 MCP 服务器加入 Hermes 配置前，可以先用 mcp-man inspect 查看其工具列表
• mcp-man test 可以直接验证工具是否正常工作，参数格式是否正确
• 避免直接在 Hermes 配置中调试 MCP 服务器（需要重启整个 agent）
• 缺点是 mcp-man 仅支持 stdio，不支持 HTTP MCP

2. mcpm.sh — 作为 MCP 包管理器

对工作流有用 ✅

• mcpm search 比浏览 GitHub 快得多
• mcpm install 可以快速搭建测试环境
• mcpm client 可以管理多客户端配置
• 但与 Hermes 无法直接集成——Hermes 使用自己的 config.yaml

3. 综合评估

总结与建议

核心发现

1. mcp-man (aaglexx/mcp-man, ⭐12) 是一个轻量级的 MCP 浏览器/调试器 — “Postman for MCP”。适合在将 MCP 服务器集成到 Hermes 前进行检查和测试。CLI + Web UI 双模式。缺点是项目极新，功能范围有限。

2. mcpm.sh (pathintegral-institute/mcpm.sh, ⭐954) 是目前最成熟的 MCP 包管理器。功能全面（搜索/安装/运行/分享/监控/多客户端），社区活跃。如果 Hermes 需要 MCP 包管理功能，这是最好的选择。

3. Hermes 原生 native-mcp 已经提供了可靠的内置 MCP 集成。不需要额外工具即可运行 MCP 服务器。但缺少搜索、浏览、测试等探索性功能。

推荐集成方案

方案 A — 轻量级（推荐）:

• 安装 mcp-man 用于快速检查和测试 MCP 服务器
• 在添加新 MCP 服务器到 Hermes 前用 mcp-man inspect+test 验证
• 服务器配置仍通过 ~/.hermes/config.yaml 管理

方案 B — 完整管理（推荐高级用户）:

• 安装 mcp-man + mcpm.sh
• 用 mcpm search 发现服务器
• 用 mcp-man inspect/test 验证接口
• 用 mcpm 生成配置后手动同步到 Hermes

方案 C — 深度集成（未来方向）:

• 可将 mcpm 的 registry 集成到 Hermes skills 中
• 或开发 Hermes plugin，将 mcpm 搜索结果直接转换为 config.yaml 配置
• 再进一步：让 Hermes 自动发现并使用 mcpm 安装的全局服务器

建议的下一步

1. ✅ 已安装 mcp-man 到全局 npm，可使用
2. ✅ 已安装 mcpm 到 pipx，可使用
3. 🔲 考虑编写 Hermes skill，封装 mcp-man 的 inspect/test 功能
4. 🔲 探索是否有 Hermes plugin 可以自动同步 mcpm 配置

本报告由 Hermes Agent 自动生成，在 WSL (Ubuntu) 环境中完成所有测试。