mcp-builder

Design, implement, and evaluate MCP servers in Python FastMCP or TypeScript MCP SDK.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/RavitejaKarra24/dotfiles --skill mcp-builder-ravitejakarra24
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/RavitejaKarra24/dotfiles/tree/main/agents/.agents/skills/mcp-builder
Command: npx skills add https://github.com/RavitejaKarra24/dotfiles --skill mcp-builder-ravitejakarra24

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building a Model Context Protocol server that LLMs can actually use effectively requires careful tool design, schema validation, transport selection, and evaluation—this Skill provides a structured four-phase workflow covering research, implementation, review, and evaluation. ## Core Features & Use Cases - Guided Four-Phase Workflow: Walks through deep research of the MCP specification and SDKs, implementation with Zod or Pydantic schemas, code review and testing with MCP Inspector, and evaluation creation. - Language-Specific References: Includes detailed implementation guides for TypeScript (registerTool, Zod schemas, streamable HTTP/stdio transports) and Python (FastMCP patterns), plus MCP best practices for naming, pagination, and error handling. - Evaluation Harness: Ships Python scripts to run XML-based QA evaluations against a live MCP server over stdio, SSE, or HTTP, producing accuracy reports with per-task tool-call metrics. - Use Case: You want to expose the GitHub API to an LLM agent. Use this Skill to plan tool coverage, implement a TypeScript MCP server with validated inputs and structured outputs, then generate 10 read-only evaluation questions and measure how well an agent answers them. ## Quick Start Ask the agent to design and build an MCP server for your chosen API using the mcp-builder workflow, starting with research and ending with an evaluation run.

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 registerTool method with Zod input schemas, explicit descriptions, and annotations. Build with npm run build, then test locally 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, independently verifiable questions, then run the bundled evaluation.py script against your server over stdio, SSE, or HTTP. It reports accuracy, tool-call counts, and per-task agent feedback.

Should I use Python FastMCP or the TypeScript MCP SDK?

TypeScript is recommended for its strong SDK support, static typing, and linting, while Python FastMCP suits Python-centric stacks. Both follow the same design principles for tool naming, schemas, and transports.

Which 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, and stdio servers must log to stderr rather than stdout.

What makes a good MCP evaluation question?

Good questions are read-only, independent, 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.