Featured

mcp-builder

Name: mcp-builder
Rating: 5 (12368 reviews)
Author: davila7

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

TL;DR

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

What Is It

MCP servers let LLMs access external services through tools
Designed for agent-centric, workflow-driven task execution
Enables LLMs to perform real-world tasks using external APIs
Supports Python (FastMCP) and Node/TypeScript (MCP SDK)

Key Features

Build tools for workflows, not just API endpoints
Optimize for limited agent context and token budget
Design actionable, educational error messages
Follow natural task subdivisions and naming conventions
Use evaluation-driven development with real agent feedback
Implement shared utilities and error handling early
Prioritize high-impact, common use-case tools
Ensure consistent input/output formats and error handling

How to Use

1.Conduct deep research and planning on agent design principles
2.Study MCP, framework, and API documentation thoroughly
3.Create a detailed implementation plan with tool selection and error handling
4.Set up project structure and implement shared utilities first
5.Develop tools systematically with proper input/output schemas
6.Test and refine tools based on agent performance and feedback

Guardrails & Gotchas

MUST avoid simply wrapping API endpoints
MUST design tools around real-world workflows
MUST optimize for limited context and token budget
MUST provide actionable, educational error messages
FORBIDDEN: do not return exhaustive data dumps
MUST use consistent, human-readable identifiers over technical codes

GitHub Stats

Author

@davila7

Repository

davila7/claude-code-templates

Stars

12368

Explore More Skills

move-code-quality

@davila7

Analyzes Move language packages against the official Move Book Code Quality Checklist. Use this skill when reviewing Move code, checking Move 2024 Edition compliance, or analyzing Move packages for best practices. Activates automatically when working with .move files or Move.toml manifests.

12.4k

1.1k

1w ago

mcp-builder

Explore More Skills

move-code-quality

e2e-testing-patterns

testing-anti-patterns