mcp-builder

Design MCP servers with typed tools, validation, and transport in Python and TypeScript.

426|199|Updated Aug 13, 2025
One-click install
npx skills add https://github.com/leonvanzyl/agentic-coding-starter-kit --skill mcp-builder-leonvanzyl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/leonvanzyl/agentic-coding-starter-kit/tree/main/.agents/skills/mcp-builder
Command: npx skills add https://github.com/leonvanzyl/agentic-coding-starter-kit --skill mcp-builder-leonvanzyl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires mcp, and includes scripts (resource) components.

What problem does it solve?

Provides a comprehensive blueprint and workflow for building Model Context Protocol (MCP) servers in Python (FastMCP) and Node/TypeScript (MCP SDK), enabling reliable tool orchestration and safe interactions between LLMs and external services.

Core Features & Use Cases

  • Provides a four-phase development process (Phase 1: Research and Planning, Phase 2: Implementation, Phase 3: Review and Test, Phase 4: Evaluations) for end-to-end MCP server development.
  • Covers language-specific guides (Python and TypeScript) with best practices, input validation (Pydantic/Zod), error handling, and tool registration patterns.
  • Emphasizes MCP Best Practices, transport strategies (stdio vs streamable HTTP), naming conventions, and quality checks to ensure production-grade reliability.

Quick Start

Clone this repository, install dependencies, then run the example MCP server as described in the guide.

Frequently Asked Questions about mcp-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server with robust input validation and secure transport?▼

To build an MCP server with robust input validation and secure transport, follow a four-phase workflow covering research, implementation, review, and evaluations, using Pydantic for Python or Zod for TypeScript to enforce well-typed tools.

What are the best practices for MCP tool registration and error handling?▼

MCP best practices for tool registration involve applying clear naming conventions, providing detailed tool descriptions, and implementing robust error handling patterns to ensure production-grade reliability when LLMs interact with external services.

Can I use this MCP server framework with both Python and TypeScript?▼

Yes, you can use this MCP server framework with both Python and TypeScript. It provides language-specific reference guides covering FastMCP for Python and the MCP SDK for Node, ensuring compatibility with MCP best practices across both implementations.

How do I handle pagination and transport strategies in an MCP server?▼

Handling pagination and transport strategies in an MCP server requires choosing between stdio and streamable HTTP transports, applying robust input validation, and following a structured four-phase development process to test and evaluate the implementation.

Why do I need a structured workflow for Model Context Protocol server development?▼

You need a structured workflow for Model Context Protocol server development to ensure safe interactions between LLMs and external services. The four-phase process guarantees thorough research, implementation, review, and evaluation for production-grade reliability.

Does this MCP server blueprint support production-grade reliability checks?▼

Yes, this MCP server blueprint supports production-grade reliability checks by emphasizing quality checks, detailed tool descriptions, and robust input validation across both Python and TypeScript implementations to ensure safe LLM tool orchestration.