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.