mcp-builder

Guides creation of MCP servers in TypeScript or Python with tool design, testing, and evaluation workflows.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill mcp-builder-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/mcp-builder
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill mcp-builder-surfingalien

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 configuration, and evaluation—this Skill provides a structured four-phase process covering all of it. ## Core Features & Use Cases - End-to-End MCP Server Workflow: Covers research and planning, implementation, review and testing, and evaluation creation for both TypeScript (MCP SDK) and Python (FastMCP) servers. - Reference Guides: Includes best practices for tool naming, pagination, transport selection (Streamable HTTP vs stdio), security (OAuth 2.1, input validation, rate limiting), and language-specific implementation patterns with Zod and Pydantic. - Evaluation Harness: Ships Python scripts to run XML-based QA evaluations against your MCP server via stdio, SSE, or HTTP transports, producing accuracy reports with per-task tool-call metrics. - Use Case: You want to expose the GitHub API to an LLM agent. Follow the guide to design tools like github_create_issue, implement them with Zod schemas and annotations, test with MCP Inspector, then generate 10 complex read-only evaluation questions and run the harness to measure agent accuracy. ## Quick Start Ask the assistant to help you build an MCP server for your chosen API, specifying whether you want TypeScript or Python 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 TypeScript?

Use the official MCP TypeScript SDK: create an McpServer instance, register tools with server.registerTool using Zod input schemas, and connect via StdioServerTransport for local use or StreamableHTTPServerTransport for remote deployment. Build with tsc and test using MCP Inspector.

How do I test an MCP server during development?

Run npx @modelcontextprotocol/inspector to launch the MCP Inspector, which shows schema errors, connection issues, and tool execution failures. For TypeScript, verify compilation first with npm run build before connecting the Inspector.

Should I use stdio or Streamable HTTP transport for my MCP server?

Use stdio for local integrations and command-line tools where the server runs as a subprocess of a single client. Use Streamable HTTP for remote servers, web services, and multi-client scenarios; it replaces the deprecated SSE transport.

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

Create an XML file with 10 complex, read-only, independently verifiable QA pairs, then run the included evaluation.py script with your transport type. It connects Claude to your server, executes each question, and reports accuracy, tool-call counts, and agent feedback.

Why does my MCP server fail to start after generation?

Common causes are missing dependencies, port conflicts, or unset environment variables. Run npm list @modelcontextprotocol/sdk to verify the SDK, check the port with lsof -i, and confirm required API keys are exported before starting.

What authentication should a remote MCP server use?

Remote MCP servers should implement OAuth 2.1 per the MCP specification, or API keys passed via the Authorization header. Never hardcode credentials; load them from environment variables and validate them at server startup.