AI导哈

MCP服务器转换工具

将MCP服务器转换为Claude技能，显著减少上下文令牌占用。

  • by YJGGZHK
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 YJGGZHK/MCP2Skills

使用说明

MCP2技能

🚀 将任何MCP服务器转换为Claude Skill，可节省90%的上下文。

为什么存在

MCP服务器在启动时将所有工具定义加载到上下文中。使用20+个工具，这意味着在克劳德做任何工作之前消耗了3-50k个代币。

该转换器应用了“渐进式披露”模式（灵感来自 剧作家技巧)对于任何MCP服务器：

  • 初创公司：~100个令牌（仅元数据）
  • 当需要时：约5k个代币（完整说明）
  • 执行：0个令牌（在外部运行）

快速开始

# 1. Install dependencies
pip install mcp

# 2. Create your MCP config file
cat > my-mcp.json << 'EOF'
{
  "name": "my-service",
  "command": "node",
  "args": ["path/to/mcp-server.js"],
  "env": {"API_TOKEN": "your-token"}
}
EOF

# 3. Convert to Skill
python mcp_to_skill_v2.py \
  --mcp-config my-mcp.json \
  --output-dir ./skills/my-service

# 4. Install to Claude
cp -r skills/my-service ~/.claude/skills/

✅ 完成！您的MCP服务器现在是Claude Skill，上下文使用最少。

它做什么

转换器创建了一个优化的技能结构：

  1. 倒像 您的MCP服务器配置
  2. 反省 MCP服务器发现所有工具
  3. 生成 完整的技能包：
    • SKILL.md -元数据和完整的工具文档
    • executor.py -动态MCP工具执行器
    • mcp-config.json -服务器配置
    • package.json -依赖关系
  4. 结果：Claude在启动时只加载约100个令牌
  5. 使用时：按需加载完整指令（约5k个令牌）
  6. 执行：工具通过MCP在外部运行（0个上下文令牌）

上下文节省

之前（MCP）:

20 tools = 30k tokens always loaded
Context available: 170k / 200k = 85%

之后（技能）:

20 skills = 2k tokens metadata
When 1 skill active: 7k tokens
Context available: 193k / 200k = 96.5%

真实案例

此存储库包括以下工作示例 技能/:

DevOps技能（23种工具）

结合ops-cli和superbus工具，完成Youzan DevOps平台集成。

上下文节省：

度量 MCP模式 技能模式 节省
闲置 ~25k代币 ~150代币 99.4%
活跃 ~25k代币 ~8k代币 68%

配置示例

使用

任何标准MCP服务器：

  • ✅ @modelcontextprotocol/server github
  • ✅ @模型上下文协议/服务器松弛
  • ✅ @模型上下文协议/服务器文件系统
  • ✅ @模型上下文协议/服务器postgres
  • ✅ 自定义MCP服务器（Node.js、Python等）

何时使用

在以下情况下使用此转换器：

  • 您有10+MCP工具
  • 上下文空间有限
  • 大多数工具不会在每次对话中使用
  • 工具是独立的，不需要跨工具协调

在以下情况下，请坚持使用原生MCP：

  • 您有1-5个工具（上下文开销最小）
  • 工具需要持久连接或复杂状态
  • 跨平台兼容性至关重要
  • 您需要实时双向通信

最佳方法：混合动力

  • 将常用的核心工具保留为MCP（始终可用）
  • 将扩展工具集转换为技能（按需加载）

需求

  • Python 3.8+
  • mcp 包裹： pip install mcp

运作原理

┌──────────────────────────────────┐
│ MCP Config (JSON)                │
│ - command, args, env             │
└────────────┬─────────────────────┘
             │
             ▼
┌──────────────────────────────────┐
│ mcp_to_skill_v2.py               │
│ - Introspects MCP server         │
│ - Generates optimized structure  │
└────────────┬─────────────────────┘
             │
             ▼
┌──────────────────────────────────┐
│ Generated Skill Package          │
│ ├── SKILL.md (~100 tokens)       │
│ ├── executor.py (dynamic)        │
│ ├── mcp-config.json              │
│ └── package.json                 │
└────────────┬─────────────────────┘
             │
             ▼
┌──────────────────────────────────┐
│ Claude Agent                     │
│ - Loads metadata at startup      │
│ - Loads full docs when needed    │
│ - Executes tools via MCP         │
└──────────────────────────────────┘

使用示例

正在转换GitHub MCP服务器

# 1. Create MCP config
cat > github.json << 'EOF'
{
  "name": "github",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-github"],
  "env": {"GITHUB_TOKEN": "ghp_your_token"}
}
EOF

# 2. Convert to Skill
python mcp_to_skill_v2.py \
  --mcp-config github.json \
  --output-dir ./skills/github

# 3. Install to Claude
cp -r ./skills/github ~/.claude/skills/

批量转换多台服务器

# Convert all configs in a directory
for config in configs/*.json; do
  name=$(basename "$config" .json)
  python mcp_to_skill_v2.py \
    --mcp-config "$config" \
    --output-dir "./skills/$name"
done

# Install all to Claude
cp -r ./skills/* ~/.claude/skills/

故障排除

“找不到mcp包”

pip install mcp

MCP服务器没有响应

检查您的配置文件：

  • 命令路径正确（用验证 which node, which npx)
  • 环境变量设置正确
  • 服务器二进制文件/包可访问
  • 首先直接测试MCP服务器

测试生成的技能

cd skills/your-skill

# List tools
python executor.py --list

# Describe a tool
python executor.py --describe tool_name

# Call a tool
python executor.py --call '{"tool": "tool_name", "arguments": {"param": "value"}}'

限制和状态

  • 早期阶段 -积极寻求反馈
  • 需要 mcp Python包
  • 复杂的身份验证流程可能需要手动调整
  • 并非所有MCP服务器都经过测试（请报告问题！）

贡献

欢迎投稿！感兴趣的领域：

  • 使用多种MCP服务器进行测试
  • 改进错误处理和诊断
  • 添加更多真实世界的示例
  • 文档改进
  • 性能优化

在以下网址打开问题或提交PR github/YJGGZHK/MCP2技能

学分

该项目基于 mcp到技能转换器 并通过附加功能和改进进行了增强。

灵感来源：

许可证

MIT许可证-有关详细信息，请参阅许可证文件

资源

相关 MCP