GBSOSS/-mcp-to-skill-converter

Registry 信息

项目简介

一个Python工具，可将任何模型上下文协议（MCP）服务器转换为Claude Skill，通过优化服务器能力向Claude的暴露方式，实现90%的上下文节省。

要点

• 将MCP服务器转换为Claude Skill
• 实现90%的上下文节省
• 基于Python实现
• 优化能力暴露方式

使用场景

• 将MCP工具与Claude集成
• 减少Claude交互中的上下文使用
• 通过外部服务器扩展Claude能力
• 优化AI工作流中的资源使用

README 摘要

# mcp-to-skill-converter Convert any MCP server into a Claude Skill with 90% context savings. ## Why This Exists MCP servers are great but load all tool definitions into context at startup. With 20+ tools, that's 30-50k tokens gone before Claude does any work. This converter applies the "progressive disclosure" pattern (inspired by playwright-skill) to any MCP server: - **Startup**: ~100 tokens (just metadata) - **When used**: ~5k tokens (full instructions) - **Executing**: 0 tokens (runs externally) ## Quick Start ```bash # 1. Create your MCP config file cat > github-mcp.json << 'EOF' { "name": "github", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": {"GITHUB_TOKEN": "your-token-here"} } EOF # 2. Convert to Skill python mcp_to_skill.py \ --mcp-config github-mcp.json \ --output-dir ./skills/github # 3. Install dependencies cd skills/github pip install mcp # 4. Copy to Claude cp -r . ~/.claude/skills/github ``` Done! Claude can now use GitHub tools with minimal context. ## What It Does The converter: 1. Reads your MCP server config 2. Generates a Skill structure with: - `SKILL.md` - Instructions for Claude - `executor.py` - Handles MCP calls dynamically - Config files 3. Claude loads metadata only (~100 tokens) 4. Full instructions load when the skill is needed 5. Executor runs MCP tools outside context ## Context Savings **Before (MCP)**: ``` 20 tools = 30k tokens always loaded Context available: 170k / 200k = 85% ``` **After (Skills)**: ``` 20 skills = 2k tokens metadata When 1 skill active: 7k tokens Context available: 193k / 200k = 96.5% ``` ## Real Example GitHub MCP server (8 tools): | Metric | MCP | Skill | Savings | |--------|-----|-------|---------| | Idle | 8,000 tokens | 100 tokens | 98.75

话题

暂无话题