creating-mcp-servers

Production MCP servers with FastMCP v2 require four mandatory patterns: uv-based dependency management, authoritative documentation fetching, optimized tool descriptions, and strategic tool selection. Start by inspecting references/MANDATORY_PATTERNS.md, then implement these patterns in your server code before bundling.

Progressive disclosure loads capabilities incrementally rather than exposing all tools at once, reducing context usage. For MCP servers with 5+ capabilities, this pattern prevents token waste by revealing tools strategically based on user need, improving performance and cost efficiency.

Use the provided bundling script to package your server: `python scripts/create_mcpb.py server.py --name <server-name> --version 1.0.0`. This creates an MCPB bundle with manifest validation, making your server ready for distribution and deployment.

Optimized tool descriptions are concise, high-density instructions that reduce context overhead. The Skill enforces patterns for writing clear, minimal descriptions that convey full functionality without verbose explanations, lowering token consumption during execution.

Yes. The Skill is designed for scalable, multi-capability servers using gateway patterns and progressive disclosure. It handles optimization for servers with 5+ tools, enabling you to build complex servers without exploding context requirements.

uv replaces pip for faster, deterministic dependency resolution and is a mandatory pattern in this Skill. It integrates with standard Python packaging and ensures reproducible builds for production MCP servers.