skills.rest
mlorentedev
mlorentedevCOMMUNITY
Explore all skills by this author →
𝕏@mlorentedevGitHub

mcp-builder

Guides creation of MCP servers in Python or TypeScript for LLM tool integration.

Updated Nov 1, 2024
Search Tags:#api integration#model context protocol#tool design#llm integration#mcp server#typescript sdk#fastmcp
One-click install
npx skills add https://github.com/mlorentedev/dotfiles --skill mcp-builder-mlorentedev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-builder
Source: https://github.com/mlorentedev/dotfiles/tree/main/harness/skills/mcp-builder
Command: npx skills add https://github.com/mlorentedev/dotfiles --skill mcp-builder-mlorentedev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building MCP (Model Context Protocol) servers that LLMs can actually use effectively requires careful tool design, schema definition, error handling, and evaluation — this Skill provides a structured four-phase workflow so your server exposes well-designed tools instead of raw API wrappers. ## Core Features & Use Cases - Four-phase workflow: Research and planning, implementation, review and testing, and evaluation, covering the full MCP server lifecycle. - Dual-language guidance: Supports Python (FastMCP) and Node/TypeScript (MCP SDK) with input schemas via Zod or Pydantic, output schemas, and tool annotations like readOnlyHint and destructiveHint. - Evaluation harness: Generates roughly 10 independent, read-only, multi-tool evaluation questions with verifiable answers in XML format. - Use Case: You want to expose your company's internal REST API to Claude. Use this Skill to design action-oriented tools with consistent naming, pagination, actionable errors, and then validate the server with the MCP Inspector. ## Quick Start Ask the AI to help you build an MCP server in TypeScript that wraps the GitHub API with well-named tools and structured output schemas.

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?▼

Use FastMCP from the Python MCP SDK to define tools with Pydantic input schemas, async I/O, and structured output. Validate the file with python -m py_compile and test it interactively using the MCP Inspector.

How do I build an MCP server in TypeScript?▼

Use the official TypeScript MCP SDK with Zod schemas for tool inputs and outputs. Compile with npm run build and test the server using npx @modelcontextprotocol/inspector before deployment.

FastMCP vs TypeScript MCP SDK, which should I use?▼

The TypeScript SDK is recommended for strong typing and broad model support, while FastMCP suits Python-centric stacks. Both support streamable HTTP for remote servers and stdio for local servers.

What transport should an MCP server use?▼

Use streamable HTTP with stateless JSON for remote servers and stdio for local servers. The choice depends on whether clients connect over a network or spawn the server as a local subprocess.

How do I test whether my MCP tools work well for LLMs?▼

Create about 10 evaluation questions that are independent, read-only, multi-tool, and have single verifiable answers, then output them as XML qa_pair elements. Verify each answer yourself by running the tools before finalizing.

What are MCP tool annotations like readOnlyHint?▼

Annotations such as readOnlyHint, destructiveHint, idempotentHint, and openWorldHint declare a tool's behavior so clients and models can reason about safety. They are set per tool alongside its schema and description.

Related Skills

Explore More Software Engineering Skills→
GamezarGamezar

mcp-build-mcp

Guide MCP server development for LLM integration with external services.

Community
Advanced
huangzesenhuangzesen
621

lingtai-mcp

Register external MCP servers from a mcp/servers.json config.

Community
Intermediate
234194027-cpu234194027-cpu

mcp-builder

Guide MCP server creation with Python FastMCP or Node TypeScript SDK.

Community
Advanced
koralliskorallis
90

mcp-builder

Build Model Context Protocol servers and tools using the @modelcontextprotocol/sdk.

Community
Intermediate