Stats
Links
Categories
MCP Wrapper Plugin
A Claude Code plugin specialized in wrapping MCP servers into efficient CLI tools following progressive disclosure and code API patterns.
Version: 1.0.0 Author: Bruno License: MIT Based on: Anthropic's "Code execution with MCP" article (November 2025)
Overview
This plugin helps you create production-ready CLI wrappers for MCP servers that achieve up to 98.7% token reduction through:
- Progressive Disclosure: 4-level help system (60-70% token savings)
- Code API Patterns: Orchestration over individual calls (98.7% savings)
- Detail Level Enums: Flexible response filtering (90-97% savings)
- Optimal Schemas: Enhanced tool definitions with examples
Installation
The plugin is located at:
/Users/bruno/.claude/plugins/claude-mcp-wrapper/
To enable it in Claude Code, it should auto-load from the plugins directory. If not:
# Verify plugin structure
ls -la /Users/bruno/.claude/plugins/claude-mcp-wrapper/
# Check plugin.json
cat /Users/bruno/.claude/plugins/claude-mcp-wrapper/.claude-plugin/plugin.json
Commands
/claude-mcp-wrapper:analyze
Analyzes an MCP server and generates a wrapping strategy.
Usage:
/claude-mcp-wrapper:analyze <mcp-server-name> [json|markdown|summary]
Examples:
/claude-mcp-wrapper:analyze github
/claude-mcp-wrapper:analyze firecrawl json
/claude-mcp-wrapper:analyze ref summary
Output:
- Tool inventory grouped by namespace
- Progressive disclosure structure (4 levels)
- Detail level recommendations
- Token efficiency estimates
- Implementation roadmap
/claude-mcp-wrapper:generate
Generates production-ready CLI wrapper code.
Usage:
/claude-mcp-wrapper:generate <mcp-server-name> [python|typescript]
Options:
--output: Output file path--template: Template style (standard|fastmcp|sdk)
Examples:
/claude-mcp-wrapper:generate github
/claude-mcp-wrapper:generate calendar typescript
/claude-mcp-wrapper:generate database python --template=fastmcp
/claude-mcp-wrapper:generate myapi --output=/path/to/cli.py
Output: Complete CLI wrapper with:
- PEP 723 header (Python) or package.json (TypeScript)
- 4-level progressive disclosure
- All tool functions
- Detail level support
- Error handling
- Output formats (json|text|table)
/claude-mcp-wrapper:scaffold
Creates complete project structure for a new MCP wrapper.
Usage:
/claude-mcp-wrapper:scaffold <project-name> [python|typescript]
Options:
--mcp-server: MCP server to wrap--with-tests: Include testing setup (default: true)--with-ci: Include CI/CD config (default: false)--output-dir: Parent directory
Examples:
/claude-mcp-wrapper:scaffold my-api-cli
/claude-mcp-wrapper:scaffold calendar-cli typescript --with-ci
/claude-mcp-wrapper:scaffold github-cli --mcp-server=github
Output: Complete project with:
- CLI wrapper script
- Documentation (README.md, CLAUDE.md)
- Environment template (.env.example)
- Testing setup
- CI/CD configuration (optional)
/claude-mcp-wrapper:convert
Converts traditional tool calls to code API patterns.
Usage:
/claude-mcp-wrapper:convert <input-file>
Options:
--output: Output file path--estimate-only: Show savings without refactoring--preserve-comments: Keep original code as comments
Examples:
/claude-mcp-wrapper:convert workflow.py
/claude-mcp-wrapper:convert script.py --estimate-only
/claude-mcp-wrapper:convert legacy.py --preserve-comments
Output:
- Refactored code using code API patterns
- Token analysis (before/after/savings)
- Pattern summary
- Migration guide
Subagents
mcp-analyzer
Analyzes MCP server structures and generates wrapping strategies.
Specializes in:
- MCP server introspection
- Tool categorization
- Namespace design
- Progressive disclosure planning
- Token efficiency analysis
Tools: Read, Bash, Grep, Glob Permission Mode: acceptEdits Color: Blue
wrapper-generator
Generates production-ready CLI wrapper code.
Specializes in:
- Code generation from templates
- Progressive disclosure implementation
- CLI framework integration (Click, argparse)
- MCP client setup
- Following established patterns
Tools: Read, Write, Edit, Bash, Glob Permission Mode: acceptEdits Color: Green
schema-optimizer
Optimizes tool schemas for maximum token efficiency.
Specializes in:
- Token efficiency analysis
- Detail level enum design
- Response structure optimization
- Schema enhancement
- Adding examples to schemas
Tools: Read, Write, Edit Permission Mode: acceptEdits Color: Purple