mcpField
M
mcp-management

mcp-management

github.com/mrgoonieAgent 工作流2.2k371 次安装30 周前更新
代码仓库

关于 mcp-management

mcp-management 是用于管理和调用 MCP 服务的技能，面向需要在 Agent 工作流中发现并执行 MCP 能力的用户。它支持多服务配置、按需能力披露，并将工具目录保存为 JSON。

主要功能

  1. 01管理多个 MCP 服务配置
  2. 02汇总发现工具、提示词和资源
  3. 03按任务选择相关工具
  4. 04通过脚本执行工具调用
  5. 05将工具目录保存为 JSON

适用场景

  1. 01查看配置服务提供的 MCP 能力
  2. 02按任务筛选并调用工具
  3. 03协调多个服务中的工具
  4. 04调试 MCP 客户端集成

MCP 相关

该技能通过客户端脚本连接配置的多个 MCP 服务，可列出工具、提示词和资源并执行工具调用。

安装

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

$npx skills add https://github.com/mrgoonie/claudekit-skills --skill mcp-management

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
assets/
tools.json
references/
configuration.md
gemini-cli-integration.md
mcp-protocol.md
scripts/
.env.example
.gitignore
cli.ts
mcp-client.ts
package.json
tsconfig.json

详细介绍

MCP 管理

用于管理和交互 Model Context Protocol（MCP）服务的技能。

概述

MCP 是一种开放协议，可让 AI Agent 连接外部工具和数据源。此技能提供脚本和实用工具，可从已配置的服务中发现、分析并执行 MCP 功能，同时避免污染主上下文窗口。

主要优势：

  • 渐进式展示 MCP 功能（仅加载所需内容）
  • 根据任务要求智能选择工具／提示词／资源
  • 通过单个配置文件管理多个服务
  • 高效利用上下文：由子 Agent 处理 MCP 发现和执行
  • 持久化工具目录：自动将发现的工具保存到 JSON，以便快速查阅

何时使用此技能

在以下情形使用此技能：

  1. 发现 MCP 功能：需要列出已配置服务中可用的工具／提示词／资源
  2. 根据任务选择工具：分析哪些 MCP 工具与特定任务相关
  3. 执行 MCP 工具：通过编程方式调用 MCP 工具，并妥善处理参数
  4. MCP 集成：构建或调试 MCP 客户端实现
  5. 上下文管理：将 MCP 操作委派给子 Agent，避免污染上下文

核心功能

1. 配置管理

MCP 服务配置在 .claude/.mcp.json 中。

Gemini CLI 集成（推荐）：创建指向 .gemini/settings.json 的符号链接：

mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json

请参阅 references/configuration.md 和 references/gemini-cli-integration.md。

2. 功能发现
npx tsx scripts/cli.ts list-tools  # Saves to assets/tools.json
npx tsx scripts/cli.ts list-prompts
npx tsx scripts/cli.ts list-resources

汇总多个服务的功能，并标明服务来源。

3. 智能工具分析

大模型直接分析 assets/tools.json，效果优于关键词匹配算法。

4. 工具执行

主要方式：Gemini CLI（如果可用）

gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

次要方式：直接使用脚本

npx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

备用方式：mcp-manager 子 Agent

完整示例请参阅 references/gemini-cli-integration.md。

实现模式

模式 1：Gemini CLI 自动执行（主要方式）

使用 Gemini CLI 自动发现并执行工具。完整指南请参阅 references/gemini-cli-integration.md。

快速示例：

gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

优势：自动发现工具、通过自然语言执行，速度快于子 Agent 编排。

模式 2：基于子 Agent 的执行（备用方式）

当 Gemini CLI 不可用时，使用 mcp-manager Agent。子 Agent 会发现工具、选择相关工具、执行任务并反馈结果。

优势：主上下文保持整洁，仅在需要时加载相关工具定义。

模式 3：由大模型驱动的工具选择

大模型读取 assets/tools.json，利用上下文理解、同义词和意图识别，智能选择相关工具。

模式 4：多服务编排

协调多个服务中的工具。每个工具都知道自己的来源服务，以便正确路由。

脚本参考

scripts/mcp-client.ts

核心 MCP 客户端管理器类，负责：

  • 从 .claude/.mcp.json 加载配置
  • 连接多个 MCP 服务
  • 列出所有服务中的工具／提示词／资源
  • 妥善处理错误并执行工具
  • 管理连接生命周期
scripts/cli.ts

用于执行 MCP 操作的命令行界面。命令：

  • list-tools - 显示所有工具并保存到 assets/tools.json
  • list-prompts - 显示所有提示词
  • list-resources - 显示所有资源
  • call-tool <server> <tool> <json> - 执行工具

注意：list-tools 会将完整工具目录（包含完整架构）持久化到 assets/tools.json，以便快速查阅、离线浏览和版本控制。

快速入门

方法 1：Gemini CLI（推荐）

npm install -g gemini-cli
mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json
gemini -y -m gemini-2.5-flash -p "Take a screenshot of https://example.com"

方法 2：脚本

cd .claude/skills/mcp-management/scripts && npm install
npx tsx cli.ts list-tools  # Saves to assets/tools.json
npx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'

方法 3：mcp-manager 子 Agent

完整指南请参阅 references/gemini-cli-integration.md。

技术详情

请参阅 references/mcp-protocol.md，了解：

  • JSON-RPC 协议详情
  • 消息类型和格式
  • 错误代码及处理方式
  • 传输机制（stdio、HTTP+SSE）
  • 最佳实践

集成策略

执行优先级

  1. Gemini CLI（首选）：快速、自动、智能选择工具

    • 检查：command -v gemini
    • 执行：gemini -y -m gemini-2.5-flash -p "<task>"
    • 适用场景：可用时执行所有任务

  2. 直接使用 CLI 脚本（次选）：手动指定工具

    • 使用场景：需要控制特定工具或服务
    • 执行：npx tsx scripts/cli.ts call-tool <server> <tool> <args>

  3. mcp-manager 子 Agent（备用）：高效利用上下文进行委派

    • 使用场景：Gemini 不可用或执行失败
    • 保持主上下文整洁
与 Agent 集成

mcp-manager Agent 使用此技能来：

  • 优先检查 Gemini CLI 是否可用
  • 如果可用，通过 gemini 命令执行
  • 失败时改用直接运行脚本
  • 发现 MCP 功能，而无需将其加载到主上下文中
  • 将结果报告给主 Agent

这样可以保持主 Agent 上下文整洁，并实现高效的 MCP 集成。

评论

支持 Markdown