mcp-builder
mcp-builder walks you through the full lifecycle of creating MCP (Model Context Protocol) servers that bridge LLMs and external services. It covers research and planning, implementation in TypeScript or Python, code review practices, and building evaluations to verify your server works effectively with real agents.
mcp-builder guides you through creating MCP servers that let LLMs interact with external services via well-designed tools.
AI-generated summary based on this skill's SKILL.md
Install
waybarrios/opencode-power-pack/mcp-builder · repository language: JavaScript
git clone https://github.com/waybarrios/opencode-power-pack
cp -r opencode-power-pack/skills/mcp-builder ~/.claude/skills/mcp-buildernpx skillfed install waybarrios/opencode-power-pack/mcp-builderFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I build an MCP server?
mcp-builder guides you through the complete process of creating MCP servers that connect LLMs to external APIs. Start by researching your target service and planning your server architecture, then implement using either TypeScript SDK or Python FastMCP. The skill covers tool design, validation, error handling, code review practices, and building evaluation frameworks to verify your server works effectively with real agents.
What are MCP tool design best practices?
mcp-builder emphasizes proper tool naming for discoverability, clear descriptions, and structured input/output schemas. Key practices include implementing robust validation and error handling to ensure tools fail gracefully, designing tools with agent usability in mind, and following MCP protocol patterns. The skill teaches you to create tools that LLMs can reliably invoke and that external services can safely process.
Should I use Python FastMCP or TypeScript SDK?
mcp-builder helps you choose between Python FastMCP and TypeScript SDK based on your project needs. Both approaches are covered with implementation examples. TypeScript offers strong typing and ecosystem integration, while Python FastMCP provides rapid development. The skill shows how to evaluate trade-offs and implement high-quality servers in either language.
How do I integrate an external service with an LLM?
mcp-builder walks through building MCP servers as the bridge between LLMs and external APIs. You'll learn to design appropriate tools that expose service capabilities, implement proper authentication and API client patterns, handle errors gracefully, and validate all inputs. The skill emphasizes creating servers that enable LLMs to reliably invoke external services while maintaining security and reliability.
How can I verify my MCP server works effectively?
mcp-builder teaches you to create evaluation frameworks and testing strategies to assess MCP server effectiveness. You'll learn to design evaluation questions that verify your server's functionality, build test cases for tools with proper validation, and assess how well real agents can use your server. The skill covers quality assessment practices to ensure your server meets production standards.
What does MCP server architecture involve?
mcp-builder covers MCP server architecture and design patterns, including how to structure your codebase, organize tools logically, implement proper error handling and validation layers, and design for maintainability. The skill teaches protocol design patterns that follow MCP best practices, ensuring your server is scalable, secure, and easy to integrate with LLM applications.
SKILL.md
rendered from the published skill — quoted content, verbatim
Overview
Create MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. The quality of an MCP server is measured by how well it enables LLMs to accomplish real-world tasks.
Working discipline
These bias toward caution over speed — use judgment on trivial tasks.
- Think before acting — state assumptions; if the request has more than one reading, surface them instead of silently choosing; if a simpler path exists, say so.
- Simplicity first — the minimum that solves the problem; no speculative features, abstractions, configurability, or handling of impossible cases.
- Surgical changes — touch only what the task needs; do not refactor or restyle adjacent code; match existing style; clean up only the orphans your change
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
skills/mcp-builder/SKILL.md