AgentSkillsCN

generate-wrapper

按照渐进式披露模式，为 MCP 服务器生成可直接投入生产的 CLI 封装代码。

SKILL.md
--- frontmatter
name: generate-wrapper
description: Generate production-ready CLI wrapper code for an MCP server following progressive disclosure patterns
context: fork
agent: wrapper-generator
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash
  - Glob

Generate CLI Wrapper Code

This skill generates complete, production-ready CLI wrapper code for MCP servers.

When This Skill Activates

Use this skill when:

  • •User wants to create a CLI wrapper for an MCP server
  • •User requests wrapper code generation
  • •User needs a Python or TypeScript wrapper
  • •User asks to wrap MCP tools in a CLI
  • •User wants to follow progressive disclosure patterns

What This Skill Does

  1. •Reads MCP server analysis or configuration
  2. •Selects appropriate template (Python/TypeScript)
  3. •Generates complete wrapper code with:
    • •PEP 723 header (Python) or package.json (TypeScript)
    • •4-level progressive disclosure help system
    • •Function routing and argument parsing
    • •Detail level enum support
    • •Error handling and validation
    • •Output format options (json|text|table)
  4. •Creates FUNCTION_INFO and FUNCTION_EXAMPLES
  5. •Tests basic functionality
  6. •Validates code syntax

Usage

code
User: "Generate a Python wrapper for the github MCP"
User: "Create a CLI tool for the firecrawl server"
User: "Generate TypeScript wrapper for my calendar API"

Arguments

The skill accepts:

  • •MCP server name (required)
  • •Language preference (python|typescript)
  • •Output path (optional)
  • •Template style (standard|fastmcp|sdk)

Output

Generates a complete CLI wrapper file:

python
#!/usr/bin/env -S uv run
# /// script
# requires-python = ">=3.8"
# dependencies = ["click", "httpx", "rich", "python-dotenv"]
# ///

# Complete implementation with:
# - 4-level progressive disclosure
# - All tool functions
# - Detail level support
# - Error handling
# - Output formatting

Example Output

For GitHub MCP:

bash
# Generated file: github-cli.py

# Test it
uv run github-cli.py --help          # Level 1: Quick help
uv run github-cli.py list            # Level 2: Function list
uv run github-cli.py info create_issue   # Level 2: Function details
uv run github-cli.py example create_issue  # Level 3: Examples
uv run github-cli.py create_issue --help   # Level 4: Complete reference

# Use it
uv run github-cli.py list_issues --repo=owner/repo
uv run github-cli.py create_issue --title="Bug" --body="Description"

Templates

Python Standard

  • •Direct MCP client integration
  • •Click-based CLI
  • •Rich formatting
  • •PEP 723 script

Python FastMCP

  • •FastMCP framework
  • •Decorator-based
  • •Pydantic validation
  • •Async support

TypeScript SDK

  • •@modelcontextprotocol/sdk
  • •Zod validation
  • •Stdio transport
  • •ESM modules

Reference Implementations

The skill studies these reference wrappers:

  • •/Users/bruno/cli-wrappers/exa.py - Example structure
  • •/Users/bruno/cli-wrappers/github.py - GitHub wrapper
  • •/Users/bruno/cli-wrappers/firecrawl.py - Firecrawl wrapper
  • •/Users/bruno/cli-wrappers/CLAUDE.md - Development guidelines

Quality Assurance

Generated code is validated for:

  • •Correct PEP 723 header syntax
  • •All dependencies listed
  • •Executable shebang
  • •4-level help completeness
  • •Function routing correctness
  • •Error handling coverage
  • •Output format support
  • •Syntax correctness

Agent Context

This skill runs in a forked context using the wrapper-generator agent, which specializes in:

  • •Code generation from templates
  • •Progressive disclosure implementation
  • •CLI framework usage (Click, argparse)
  • •MCP client integration
  • •Following established patterns from ~/cli-wrappers/