MCP服务器管理工具

MCPGod是一个CLI工具,帮助开发者快速便捷地管理MCP服务器,包括添加、运行、列出和移除服务器,以及交互式工具调用和权限管理。

  • by mcpgod
  • TypeScript
  • 本地部署
  • 115 星标
  • 更新于

使用说明

MCPGod

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

概述

MCPGod 是一个CLI工具,旨在帮助开发人员快速轻松地管理MCP服务器。您是否需要添加、运行、列出或删除服务器,甚至需要与服务器工具交互--MCPGod 提供了一个简化的界面,可以在Windows、macOS或Linux上处理所有这些任务。

特性

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

安装

安装 mcpgod 全球使用 npm:

npm install -g mcpgod

验证安装:

mcpgod --version

或者直接与 npx.

npx -y mcpgod

用法

使用以下命令访问CLI mcpgod 命令(或 npx -y mcpgod).以下是一些常见的例子:

  • 将服务器添加到客户端

    使用以下命令将MCP服务器添加到客户端(例如Claude) 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> [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 框架和使用 模型上下文协议SDK 用于与MCP服务器进行稳健的交互。

克隆存储库以开始开发:

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

在开发模式下运行CLI:

./bin/dev

出版

自动发布由 version, tag and github release 工作流程。每当版本冲突被合并到npm中时,就会发布一个新的npm版本 main 支。工作流也可以从以下位置手动触发 行动 选项卡。

要启用发布,请设置以下存储库机密:

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

一旦配置了secrets,推送新版本或手动运行工作流将构建项目,创建GitHub版本并将包发布到npm。

过梁工作流程

在将更改提交到工作流之前,您可以在本地对其进行整理:

npm run lint:workflows

贡献

捐款总是受欢迎的!贡献:

  1. 分叉 存储库。
  2. 创建分支:
    git checkout -b feature/your-feature
    
  3. 进行更改,并承诺:
    git commit -am 'Add new feature'
    
  4. 推 您的分支:
    git push origin feature/your-feature
    
  5. 打开拉取请求 在GitHub上。

许可证

该项目根据 MIT许可证.


额外资源