星战科技xingzhan.cloud
返回市场
客户端

客户端

作者：mcpgod113 星标更新：2025-06-14
安装使用来源：spider==github.com

项目介绍

MCPGod

对模型上下文协议（MCP）客户端、服务器和工具进行细粒度控制。上下文就是上帝。

oclif Version Downloads/week License Coverage

概述

MCPGod 是一个设计用于帮助开发者快速轻松管理 MCP 服务器的 CLI 工具。无论您需要添加、运行、列出或移除服务器，甚至与服务器工具交互，MCPGod 都提供了一个统一的界面来处理这些任务，适用于 Windows、macOS 或 Linux。

特性

  • 客户端管理
    添加、移除和列出特定客户端的 MCP 服务器。
  • 工具发现 列出任何 MCP 服务器上的每个工具。
  • 工具调用 直接从命令行运行任何 MCP 服务器上的任何工具。
  • 工具/客户端权限 允许或阻止特定客户端的特定工具。
  • 详细日志 记录每个客户端的每次服务器运行，带有时间戳和干净的输出，便于调试。

安装

使用 npm 全局安装 mcpgod：

npm install -g mcpgod

验证安装：

mcpgod --version

或者直接使用 npx 运行。

npx -y mcpgod

使用

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

  • 向客户端添加服务器

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

    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

  • 移除服务器

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

    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> [可选参数]：

    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. 分叉 仓库。
  2. 创建分支： 
    git checkout -b feature/your-feature
  3. 做出您的更改 并提交它们： 
    git commit -am '添加新功能'
  4. 推送 您的分支： 
    git push origin feature/your-feature
  5. 在 GitHub 上 打开一个拉取请求。

许可证

此项目根据 MIT 许可证授权。

额外资源