⚡

MCP管理Skill mcp-management

MCP管理技能用于管理和交互Model Context Protocol（MCP）服务器，支持AI代理连接到外部工具和数据源。该技能提供工具发现、分析和执行功能，适用于MCP集成、上下文管理、多服务器管理，优化AI工作流，提升开发效率。关键词：MCP管理、AI代理、工具集成、上下文管理、MCP服务器、智能工具选择。

AI智能体 0 次安装 0 次浏览 更新于 3/17/2026

name: mcp-management description: 管理 Model Context Protocol (MCP) 服务器 - 发现、分析和执行来自配置的 MCP 服务器的工具/提示/资源。当处理 MCP 集成时使用，需要发现可用的 MCP 功能，为特定任务筛选 MCP 工具，以编程方式执行 MCP 工具，访问 MCP 提示/资源，或实现 MCP 客户端功能。支持智能工具选择、多服务器管理和上下文高效的能力发现。

MCP 管理

用于管理和交互 Model Context Protocol (MCP) 服务器的技能。

概述

MCP 是一个开放协议，使 AI 代理能够连接到外部工具和数据源。此技能提供脚本和实用程序，从配置的服务器发现、分析和执行 MCP 能力，而不会污染主上下文窗口。

主要优点:

  • MCP 能力的逐步披露（仅加载所需内容）
  • 基于任务需求的智能工具/提示/资源选择
  • 通过单个配置文件进行多服务器管理
  • 上下文高效：子代理处理 MCP 发现和执行
  • 持久工具目录：自动将发现的工具保存到 JSON 以供快速参考

何时使用此技能

使用此技能当：

  1. 发现 MCP 能力: 需要列出可用工具/提示/资源从配置的服务器
  2. 基于任务的任务选择: 分析哪些 MCP 工具与特定任务相关
  3. 执行 MCP 工具: 以编程方式调用 MCP 工具，带有适当的参数处理
  4. MCP 集成: 构建或调试 MCP 客户端实现
  5. 上下文管理: 通过将 MCP 操作委托给子代理来避免上下文污染

核心能力

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  # 保存到 assets/tools.json
npx tsx scripts/cli.ts list-prompts
npx tsx scripts/cli.ts list-resources

聚合来自多个服务器的能力，带有服务器标识。

3. 智能工具分析

LLM 直接分析 assets/tools.json - 优于关键字匹配算法。

4. 工具执行

主要：Gemini CLI（如果可用）

gemini -y -m gemini-2.5-flash -p "拍摄 https://example.com 的截图"

次要：直接脚本

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

后备：mcp-manager 子代理

参见 references/gemini-cli-integration.md 获取完整示例。

实现模式

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

使用 Gemini CLI 进行自动工具发现和执行。参见 references/gemini-cli-integration.md 获取完整指南。

快速示例:

gemini -y -m gemini-2.5-flash -p "拍摄 https://example.com 的截图"

优点: 自动工具发现，自然语言执行，比子代理编排更快。

模式 2: 基于子代理的执行（后备）

当 Gemini CLI 不可用时使用 mcp-manager 代理。子代理发现工具，选择相关工具，执行任务，报告回来。

优点: 主上下文保持清洁，仅在需要时加载相关工具定义。

模式 3: LLM 驱动的工具选择

LLM 读取 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 "拍摄 https://example.com 的截图"

方法 2: 脚本

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

方法 3: mcp-manager 子代理

参见 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 "<任务>"
    • 最佳用于: 可用时的所有任务

  2. 直接 CLI 脚本（次要）: 手动工具规范

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

  3. mcp-manager 子代理（后备）: 上下文高效委托

    • 使用当: Gemini 不可用或失败
    • 保持主上下文清洁

与代理集成

mcp-manager 代理使用此技能来：

  • 首先检查 Gemini CLI 可用性
  • 如果可用，通过 gemini 命令执行
  • 后备到直接脚本执行
  • 发现 MCP 能力而无需加载到主上下文
  • 向主代理报告结果

这保持主代理上下文清洁，并实现高效的 MCP 集成。