mcpField
M
mcp-server-manager

mcp-server-manager

github.com/xiaolaiAgent 工作流87864 次安装今天更新
代码仓库

关于 mcp-server-manager

用于管理 MCP 服务配置的 Agent 技能,可发现项目和全局配置,并注册、验证服务。支持项目级 .mcp.json 与 Claude Code 全局配置。

主要功能

  1. 01扫描项目与全局 MCP 配置
  2. 02识别 HTTP 与 stdio 服务类型
  3. 03注册项目级或全局服务
  4. 04验证服务注册状态
  5. 05提示重启会话以加载服务

适用场景

  1. 01检查现有 MCP 服务配置
  2. 02将服务添加到项目或 Claude Code
  3. 03确认注册成功并告知重启要求

MCP 相关

该技能通过编辑 .mcp.json 或使用 Claude Code 的命令注册 MCP 服务,并检查配置确认注册结果。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/xiaolai/vmark --skill mcp-server-manager

安装后在 Claude Code 中输入/mcp-server-manager确认已加载。

附带文件scripts/scan_mcp_servers.py

详细介绍

MCP 服务管理器

工作流

  1. 发现候选服务

    • 检查项目的 .mcp.json,查看是否已有服务配置。
    • 检查 ~/.claude.json,查看全局 MCP 服务(Claude Code)。
    • 扫描 package.json 或 Cargo.toml 中与 MCP 相关的包。
  2. 选择注册目标

    • 项目本地:直接编辑 .mcp.json。
    • 全局(Claude Code):使用 claude mcp add / claude mcp remove。
  3. 注册服务

    • stdio 服务:
      claude mcp add <name> -- <command> <args...>
      
    • 带环境变量的 stdio 服务:
      claude mcp add <name> -e KEY=VALUE -- <command> <args...>
      
    • 或直接编辑 .mcp.json 以配置项目本地服务。
  4. 验证注册

    • 对于 .mcp.json:读取文件并确认条目存在。
    • 对于全局服务:运行 claude mcp list 进行验证。
  5. 说明重新加载要求

    • MCP 服务会在会话开始时加载;请用户重启会话。

注意事项

  • 根据配置推断类型:url 键表示 HTTP,command/args 键表示 stdio。
  • 如果多个来源定义了同一个名称,请确认使用哪一个。
  • 对于使用 npx 的 stdio 服务,软件包会在服务首次运行时下载。

VMark 示例

// .mcp.json
{
  "mcpServers": {
    "tauri": {
      "command": "npx",
      "args": ["-y", "@hypothesi/tauri-mcp-server"]
    }
  }
}

评论

支持 Markdown