GBSOSS/-mcp-to-skill-converter

Registry

Summary

A Python tool that converts any Model Context Protocol (MCP) server into a Claude Skill, achieving 90% context savings by optimizing how server capabilities are exposed to Claude.

Key features

• Converts MCP servers to Claude Skills
• Achieves 90% context savings
• Python-based implementation
• Optimizes capability exposure

Use cases

• Integrating MCP tools with Claude
• Reducing context usage in Claude interactions
• Extending Claude's capabilities with external servers
• Optimizing resource usage in AI workflows

README excerpt

# 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

Topics

No topics yet.