SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场mcp-management

mcp-management

智能体与模型

查看项目

更新于 10-15 20:21

技能介绍

用途

MCP Management 是一个用于管理和交互 Model Context Protocol（MCP）服务器的技能。MCP 是一种开放协议，使 AI 智能体能够连接外部工具和数据源。该技能提供脚本和实用工具，用于从已配置的服务器中发现、分析并执行 MCP 能力，同时不污染主上下文窗口。

主要能力

  • 配置管理：MCP 服务器在 .claude/.mcp.json 中配置。推荐与 Gemini CLI 集成，通过创建指向 .gemini/settings.json 的符号链接实现。
  • 能力发现：通过命令行列出工具、提示词和资源，并聚合来自多个服务器的能力，附带服务器标识。
  • 智能工具分析：由 LLM 直接分析 assets/tools.json，优于关键词匹配算法。
  • 工具执行：支持三种执行方式（见下文）。
  • 持久化工具目录：list-tools 会将完整工具目录及完整 schema 保存到 assets/tools.json，便于快速引用、离线浏览和版本控制。

使用方式

方法一：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"

方法二：脚本

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":[...]}'

方法三：mcp-manager 子代理

参见 references/gemini-cli-integration.md 获取完整指南。

命令行命令

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

执行优先级

  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 子代理（回退）：上下文高效的委托。当 Gemini 不可用或失败时使用，保持主上下文干净。

实现模式

  • 模式一：Gemini CLI 自动执行（主要）：自动工具发现、自然语言执行，比子代理编排更快。
  • 模式二：基于子代理的执行（回退）：当 Gemini CLI 不可用时使用 mcp-manager 代理，主上下文保持干净，仅在需要时加载相关工具定义。
  • 模式三：LLM 驱动的工具选择：LLM 读取 assets/tools.json，利用上下文理解、同义词和意图识别智能选择相关工具。
  • 模式四：多服务器编排：跨多个服务器协调工具，每个工具知道其来源服务器以便正确路由。

脚本参考

  • scripts/mcp-client.ts：核心 MCP 客户端管理器类，处理从 .claude/.mcp.json 加载配置、连接多个 MCP 服务器、跨所有服务器列出工具/提示词/资源、执行工具并处理错误、连接生命周期管理。
  • scripts/cli.ts：MCP 操作的命令行界面。

适用场景

  • 发现 MCP 能力：列出已配置服务器中可用的工具/提示词/资源
  • 基于任务的工具选择：分析哪些 MCP 工具与特定任务相关
  • 执行 MCP 工具：以编程方式调用 MCP 工具并正确处理参数
  • MCP 集成：构建或调试 MCP 客户端实现
  • 上下文管理：通过将 MCP 操作委托给子代理来避免上下文污染

与代理的集成

mcp-manager 代理使用此技能来：首先检查 Gemini CLI 可用性；如可用则通过 gemini 命令执行；回退到直接脚本执行；在不加载到主上下文的情况下发现 MCP 能力；将结果报告回主代理。这保持了主代理上下文干净，并实现高效的 MCP 集成。

技术细节

参见 references/mcp-protocol.md 了解 JSON-RPC 协议细节、消息类型和格式、错误码和处理、传输机制（stdio、HTTP+SSE）以及最佳实践。

限制

资料中未提供关于收费、价格、平台支持范围或具体效果保证的信息。