mcp-builder

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

1|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/ginaecho/skill-achievability-compiler --skill mcp-builder-ginaecho
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/ginaecho/skill-achievability-compiler/tree/main/demo/real-skill-cases/natural-language/mcp-builder
Command: npx skills add https://github.com/ginaecho/skill-achievability-compiler --skill mcp-builder-ginaecho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building an MCP server that LLMs can actually use effectively requires careful tool design, protocol knowledge, and testing—this Skill provides a structured four-phase process covering research, implementation, review, and evaluation. ## Core Features & Use Cases - Four-Phase Workflow: Deep research and planning, implementation, review and testing, and evaluation creation for MCP servers. - Language-Specific Guidance: Reference guides for TypeScript (MCP SDK with Zod schemas) and Python (FastMCP with Pydantic models), including project structure and quality checklists. - Evaluation Framework: Instructions for creating 10 complex, read-only, verifiable evaluation questions in XML format to test whether LLMs can use the server effectively. - Use Case: You need to expose a third-party API to an LLM agent. Follow the workflow to design well-named tools with actionable error messages, implement them with the TypeScript SDK, test with MCP Inspector, and generate an evaluation suite. ## Quick Start Use the mcp-builder skill to help me build an MCP server in TypeScript that wraps the GitHub API with tools for issues and repositories.

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 Model Context Protocol TypeScript SDK with Zod for input schemas and server.registerTool for tool registration. The Skill's TypeScript guide covers project structure, package.json, tsconfig.json, and complete working examples.

How do I build an MCP server in Python?▼

Use FastMCP from the MCP Python SDK, defining tools with the @mcp.tool decorator and Pydantic models for input validation. The Python guide covers server initialization, module organization, and a quality checklist.

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

Use streamable HTTP with stateless JSON for remote servers since it scales and is simpler to maintain. Use stdio for local servers that run as subprocesses of the client.

How do I test an MCP server after building it?▼

Test with the MCP Inspector tool by running npx @modelcontextprotocol/inspector for interactive tool testing. For TypeScript, verify compilation with npm run build; for Python, check syntax with python -m py_compile.

What makes a good MCP tool description for LLMs?▼

Good tool descriptions include a concise functionality summary, parameter descriptions, and return type schema. Use consistent prefixes like github_create_issue, add annotations such as readOnlyHint and destructiveHint, and write error messages that suggest next steps.