mcpField
M
mcp-management

mcp-management

github.com/secondskyAgent 工作流240386 次安装5 周前更新
代码仓库

关于 mcp-management

供 Agent 管理已配置 MCP 服务并调用其能力的技能。它汇总多个服务的工具、提示词和资源，支持智能筛选与执行，也可将操作交给子 Agent，以减少主上下文负担。

主要功能

  1. 01通过单一配置管理多个服务
  2. 02列出工具、提示词和资源
  3. 03将发现的工具保存为 JSON
  4. 04筛选并执行相关工具
  5. 05委派操作给子 Agent

适用场景

  1. 01查找已配置服务提供的能力
  2. 02传入参数调用指定工具
  3. 03将发现操作移出主上下文

MCP 相关

它作为 MCP 客户端运行，可发现已配置 MCP 服务的工具、提示词和资源并调用工具；执行方式包括 Gemini CLI、脚本或子 Agent。

安装

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

$npx skills add https://github.com/secondsky/claude-skills --skill mcp-management

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

详细介绍

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
2. 功能发现
# Preferred: Using bun (faster)
bunx tsx scripts/cli.ts list-tools  # Saves to assets/tools.json
bunx tsx scripts/cli.ts list-prompts
bunx tsx scripts/cli.ts list-resources

# Alternative: Using bunx
bunx tsx scripts/cli.ts list-tools
bunx tsx scripts/cli.ts list-prompts
bunx 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"

次要方式：直接运行脚本

# Preferred: Using bun
bunx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

# Alternative: Using bunx
bunx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

备用方式：mcp-manager 子 Agent

实现模式

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

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

快速示例：

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：多服务编排

协调多个服务中的工具。每个工具都记录其来源服务，以便正确路由。

快速开始

方法 1：Gemini CLI（推荐）

bun install -g gemini-cli  # or: 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  # or: bun install
bunx tsx cli.ts list-tools  # Saves to assets/tools.json
bunx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'

方法 3：mcp-manager 子 Agent

调度子 Agent 处理 MCP 操作，同时保持主上下文整洁。

安全安装

安装 MCP 服务包时，请遵循供应链安全最佳实践：

  • 阻止安装后脚本——npm config set ignore-scripts true（或使用 Bun：默认禁用）
  • 冷却期——等待 7 天，让社区审查新版本的软件包
  • 安装前审计——运行 socket package score npm <pkg>，或使用 socket npm install <pkg> 检查软件包

加载 dependency-upgrade 技能，获取完整的安全配置，包括 Socket CLI 集成、冷却期设置、锁文件验证和 CI 强制执行。

集成策略

执行优先级

  1. Gemini CLI（主要方式）：快速、自动、智能地选择工具

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

  2. 直接调用 CLI 脚本（次要方式）：手动指定工具

    • 使用场景：需要控制特定工具或服务
    • 执行：bunx 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