⚡

MCP管理 mcp-management

这个技能用于管理和交互Model Context Protocol (MCP) 服务器，帮助AI代理连接外部工具和数据源，实现能力发现、智能工具选择、程序化执行和上下文高效管理，避免污染主上下文窗口。关键词：MCP管理，AI代理工具集成，能力发现，工具过滤，上下文高效。

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

name: mcp-management description: 管理MCP服务器 - 发现、分析、执行工具/提示/资源。用于MCP集成、能力发现、工具过滤、程序化执行，或处理上下文膨胀、服务器配置、工具执行错误。 keywords: MCP, Model Context Protocol, 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

2. 能力发现

# 首选：使用 bun（更快）
bunx tsx scripts/cli.ts list-tools  # 保存到 assets/tools.json
bunx tsx scripts/cli.ts list-prompts
bunx tsx scripts/cli.ts list-resources

# 替代：使用 bunx
bunx tsx scripts/cli.ts list-tools
bunx tsx scripts/cli.ts list-prompts
bunx tsx scripts/cli.ts list-resources

从多个服务器聚合能力，并标识服务器。

3. 智能工具分析

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

4. 工具执行

首选：Gemini CLI（如果可用）

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

次级：直接脚本

# 首选：使用 bun
bunx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

# 替代：使用 bunx
bunx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

后备：mcp-manager子代理

实现模式

模式1：Gemini CLI自动执行（首选）

使用Gemini CLI进行自动工具发现和执行。

快速示例：

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

优势：自动工具发现，自然语言执行，快于子代理编排。

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

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

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

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

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

模式4：多服务器编排

跨多个服务器协调工具。每个工具知道其源服务器以便正确路由。

快速开始

方法1：Gemini CLI（推荐）

bun install -g gemini-cli  # 或：bun add -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
bun install  # 或：bun install
bunx tsx cli.ts list-tools  # 保存到 assets/tools.json
bunx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'

方法3：mcp-manager子代理

派遣子代理处理MCP操作，保持主上下文清洁。

集成策略

执行优先级

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

    • 检查：command -v gemini
    • 执行：gemini -y -m gemini-2.5-flash -p "<任务>"
    • 最佳用途：所有任务，当可用时

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

    • 使用场景：需要特定工具/服务器控制时
    • 执行：bunx tsx scripts/cli.ts call-tool <服务器> <工具> <参数>

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

    • 使用场景：Gemini不可用或失败时
    • 保持主上下文清洁

与代理集成

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

  • 首先检查Gemini CLI可用性
  • 如果可用，通过 gemini 命令执行
  • 后备到直接脚本执行
  • 在不加载到主上下文的情况下发现MCP能力
  • 将结果报告回主代理

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