MCPGod

MCPGod

对模型上下文协议（MCP）客户端、服务和工具进行精细控制。上下文即一切。

概述

MCPGod 是一款 CLI 工具，旨在帮助开发者快速、轻松地管理 MCP 服务。无论你需要添加、运行、列出或移除服务，还是与服务工具交互，MCPGod 都能提供简洁的界面，帮助你在 Windows、macOS 或 Linux 上完成这些任务。

功能

• 客户端管理
  为特定客户端添加、移除和列出 MCP 服务。
• 工具发现 列出任意 MCP 服务上的所有工具。
• 工具调用 直接从命令行运行任意 MCP 服务上的任意工具。
• 工具/客户端权限 允许或阻止特定客户端使用特定工具。
• 详细日志 记录每个客户端运行服务的情况，并附上时间戳和清晰的输出，便于调试。

安装

使用 npm 全局安装 mcpgod：

npm install -g mcpgod

验证安装：

mcpgod --version

也可以使用 npx 直接运行。

npx -y mcpgod

使用方法

使用 mcpgod 命令（或 npx -y mcpgod）访问 CLI。以下是一些常见示例：

• 向客户端添加服务

  使用 mcpgod add <SERVER> -c <CLIENT> 向客户端（例如 Claude）添加 MCP 服务：

  mcpgod add @modelcontextprotocol/server-everything -c claude
  

• 仅向客户端添加指定工具

  使用 mcpgod add <SERVER> -c <CLIENT> --tools=<COMMA_DELIMITED_LIST> 仅向客户端添加指定工具：

  mcpgod add @modelcontextprotocol/server-everything -c claude --tools=echo,add
  

• 列出客户端的服务

  使用 mcpgod list -c <CLIENT> 列出特定客户端的所有已配置服务：

  mcpgod list -c claude
  

• 移除服务

  使用 mcpgod remove <SERVER> -c <CLIENT> 从客户端配置中移除 MCP 服务：

  mcpgod remove @modelcontextprotocol/server-everything -c claude
  

• 运行服务

  使用 mcpgod run <SERVER> 运行服务进程并记录详细日志：

  mcpgod run @modelcontextprotocol/server-everything
  mcpgod run ./mcp-server.py
  mcpgod run ./mcp-server-node.mjs
  

• 列出服务的可用工具

  使用 mcpgod tools <SERVER> 显示服务上可用工具的列表：

  mcpgod tools @modelcontextprotocol/server-everything
  mcpgod tools ./mcp-server.py
  mcpgod tools ./mcp-server-node.mjs
  

• 调用服务上的指定工具

  使用 mcpgod tool <SERVER> <TOOL> [optional parameters] 传入键值属性，与工具交互：

  mcpgod tool @modelcontextprotocol/server-everything add a=59 b=40
  mcpgod tool ./mcp-server.py echo message=hi
  mcpgod tool ./mcp-server-node.mjs echo message=hi
  

如需查看完整的命令和选项列表，只需运行：

mcpgod --help

日志记录

运行服务时，mcpgod 会将输出记录到：

~/mcpgod/logs

每个日志文件都按服务名称整理并标注时间戳，方便你追踪和调试遇到的问题。

开发

mcpgod 使用 Oclif 框架构建，并使用 Model Context Protocol SDK 与 MCP 服务进行可靠交互。

克隆代码仓库以开始开发：

git clone https://github.com/mcpgod/cli.git
cd mcpgod
npm install

以开发模式运行 CLI：

./bin/dev

发布

自动发布由 version, tag and github release 工作流处理。将版本升级合并到 main 分支后，系统会发布新的 npm 版本。也可以从 Actions 选项卡手动触发该工作流。

要启用发布功能，请设置以下代码仓库密钥：

• NPM_TOKEN – npm 的身份验证令牌。
• GH_EMAIL 和 GH_USERNAME – 供 README 更新步骤使用。

配置好密钥后，推送新版本或手动运行工作流，即可构建项目、创建 GitHub 发布并将软件包发布到 npm。

工作流代码检查

提交对工作流的更改前，可以在本地检查代码：

npm run lint:workflows

贡献

欢迎随时贡献！贡献方式如下：

1. Fork 此仓库。
2. 创建分支：

   git checkout -b feature/your-feature
   

3. 进行更改并提交：

   git commit -am 'Add new feature'
   

4. 推送分支：

   git push origin feature/your-feature
   

5. 在 GitHub 上创建 Pull Request。

许可证

本项目采用 MIT 许可证。

---

其他资源

• Oclif CLI 框架
• Model Context Protocol
• npm Package mcpgod

---