mcp-builder

Guides building and evaluating MCP servers in Python or TypeScript.

1|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/mccleod1290/bb-agentic-setupv2 --skill mcp-builder-mccleod1290
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/mccleod1290/bb-agentic-setupv2/tree/main/documenting-skills/mcp-builder
Command: npx skills add https://github.com/mccleod1290/bb-agentic-setupv2 --skill mcp-builder-mccleod1290

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building MCP (Model Context Protocol) servers that LLMs can actually use effectively requires careful tool design, schema validation, transport selection, and evaluation—this Skill provides a structured four-phase process to do it right. ## Core Features & Use Cases - Four-Phase Workflow: Deep research and planning, implementation, review and testing, and evaluation creation for MCP servers. - Language-Specific Guides: Reference documentation for Python (FastMCP) and Node/TypeScript (MCP SDK) with naming conventions, Zod/Pydantic schemas, pagination, and error handling patterns. - Evaluation Harness: Scripts to run XML-based QA evaluations against your MCP server over stdio, SSE, or streamable HTTP transports, producing accuracy reports. - Use Case: You need to expose the GitHub API to an LLM agent. Follow the guide to design tools like github_create_issue, implement them with proper annotations and pagination, then generate 10 complex read-only evaluation questions and run the harness to measure agent accuracy. ## Quick Start Ask the agent to help you build an MCP server for your chosen API, specifying whether you want Python or TypeScript and which transport to use.

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 Python or TypeScript?▼

Follow the four-phase process: research the MCP spec and target API, implement tools using FastMCP (Python) or the TypeScript SDK with registerTool, test with MCP Inspector, then create evaluations. Reference guides cover project structure, schemas, and complete working examples for both languages.

How do I test and evaluate an MCP server?▼

Create an XML file with 10 read-only, verifiable QA pairs, then run scripts/evaluation.py with your transport type (stdio, sse, or http). The harness connects to your server, runs each question through Claude, and reports accuracy, duration, and tool-call metrics.

Should I use stdio or streamable HTTP transport for MCP?▼

Use stdio for local integrations and single-client command-line tools; use streamable HTTP for remote servers serving multiple clients. SSE is deprecated in favor of streamable HTTP, and stdio servers must log to stderr, not stdout.

What makes a good MCP tool design?▼

Use snake_case names with service prefixes like github_create_issue, provide Zod or Pydantic input schemas with constraints, set annotations (readOnlyHint, destructiveHint), support pagination with limit/offset, and return actionable error messages that guide agents toward correct usage.

What are the requirements for MCP evaluation questions?▼

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