mcp-builder

Guides building and evaluating MCP servers in Python or TypeScript.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill mcp-builder-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/mcp-builder
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill mcp-builder-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building Model Context Protocol servers that LLMs can actually use effectively requires careful tool design, schema validation, transport selection, and testing, which is easy to get wrong without a structured process. ## Core Features & Use Cases - Four-Phase Development Workflow: Covers research and planning, implementation, review and testing, and evaluation creation for MCP servers. - Language-Specific Guides: Provides implementation references for Python (FastMCP) and Node/TypeScript (MCP SDK) with Zod/Pydantic validation patterns. - Evaluation Harness: Includes scripts to run XML-based QA evaluations against a live MCP server over stdio, SSE, or streamable HTTP transports. - Use Case: You need to expose a GitHub-like API to an LLM agent. Follow the guide to design tools with proper naming, annotations, and pagination, then generate 10 evaluation questions and run the harness to measure answer accuracy. ## Quick Start Ask the agent to build an MCP server for your chosen API using the mcp-builder guide and then evaluate it with the provided evaluation script.

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 in TypeScript?

Use the MCP TypeScript SDK's McpServer class and register tools with server.registerTool, providing title, description, Zod inputSchema, and annotations. Build with npm run build and test using the MCP Inspector via npx @modelcontextprotocol/inspector.

How do I test whether my MCP server works well with LLMs?

Create an XML evaluation file with 10 read-only, verifiable question-answer pairs, then run scripts/evaluation.py against your server over stdio, SSE, or HTTP. The harness reports accuracy, tool call counts, and agent feedback on tool design.

Should I use Python FastMCP or the TypeScript MCP SDK?

TypeScript is recommended for its strong SDK support, static typing, and linting, though Python with FastMCP is fully supported. Both follow the same design principles for tool naming, schemas, and error handling.

What transport should an MCP server use, stdio or HTTP?

Use stdio for local single-client integrations and streamable HTTP for remote multi-client deployments. SSE is deprecated in favor of streamable HTTP, which supports stateless JSON responses that scale more easily.

What makes a good MCP evaluation question?

Questions must be independent, read-only, complex enough to require multiple tool calls, and have a single stable answer verifiable by string comparison. Avoid questions about current state like open issue counts, since answers change over time.