mcp-management

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

主要优势

MCP 能力的渐进式披露：只加载所需内容
基于任务需求的智能工具、提示词和资源选择
通过单一配置文件管理多个服务器
上下文高效：由子代理负责 MCP 的发现与执行
持久化工具目录：自动将发现的工具保存为 JSON 以便快速参考

使用场景

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

核心能力

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. 智能工具分析

由 LLM 直接分析 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 子代理

实现模式

模式 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  # 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 子代理

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

安全安装

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

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

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

集成策略

执行优先级

Gemini CLI（首选）：快速、自动、智能工具选择
- 检查：command -v gemini
- 执行：gemini -y -m gemini-2.5-flash -p "<task>"
- 最适合：所有可用时的任务
直接 CLI 脚本（次选）：手动指定工具
- 使用时机：需要特定的工具或服务器控制
- 执行：bunx tsx scripts/cli.ts call-tool <server> <tool> <args>
mcp-manager 子代理（回退）：上下文高效的委派
- 使用时机：Gemini 不可用或执行失败
- 保持主上下文整洁

与代理集成

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

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

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

限制

关于该技能的定价、具体平台支持范围或性能数据，资料中暂未提供。