mcp-builder

Guide for building high-quality MCP servers with well-designed tools for LLMs to interact with external services.

• Enable LLMs to interact with external services via tools
• Balance API coverage with workflow tools for flexibility
• Use clear, descriptive tool names for discoverability
• Implement structured, actionable error messages

• Prioritize comprehensive API coverage over workflow tools
• Use consistent, action-oriented tool naming (e.g., github_create_issue)
• Design tools with concise descriptions and clear parameters
• Support pagination and filtering for efficient data handling
• Include structured output and actionable error messages
• Use structuredContent in modern SDKs for better client understanding
• Implement DRY principles and consistent error handling
• Create 10 evaluation questions to test real-world effectiveness

1. 1.Conduct deep research and plan tool implementation
2. 2.Set up project structure and implement core infrastructure
3. 3.Develop tools with proper input/output schemas and descriptions
4. 4.Test with MCP Inspector and run evaluations
5. 5.Iterate based on evaluation results