build-mcp-server

Guide developers through building an MCP server from discovery to scaffolding.

Updated Sep 30, 2024
One-click install
npx skills add https://github.com/phillip-hirsch/dotfiles --skill build-mcp-server-phillip-hirsch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-mcp-server
Source: https://github.com/phillip-hirsch/dotfiles/tree/main/.claude/plugins/marketplaces/claude-plugins-official/plugins/mcp-server-dev/skills/build-mcp-server
Command: npx skills add https://github.com/phillip-hirsch/dotfiles --skill build-mcp-server-phillip-hirsch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses the complexities of building an MCP server by guiding developers through the entire process, from discovery to deployment.

Core Features & Use Cases

  • Discovery: Interrogates the user about their use case to determine the right deployment model and tool-design pattern.
  • Deployment Model: Recommends a deployment model based on the user's needs, including remote HTTP, MCPB, local stdio, and MCP app widgets.
  • Tool-Design Pattern: Selects an appropriate tool-design pattern for the server, such as one tool per action or search + execute.
  • Framework: Recommends a framework for development, such as the Official TypeScript SDK or FastMCP 3.x.
  • Scaffolding and Handoff: Provides inline scaffolding and handoff to specialized skills for specific tasks.

Quick Start

Use the build-mcp-server skill to start building your MCP server by providing the details of your use case.

Frequently Asked Questions about build-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server for Claude?

Building an MCP server involves selecting a deployment model, designing tools, choosing a framework like the Official TypeScript SDK or FastMCP, and scaffolding the project. The workflow requires understanding Claude's constraints and MCP specifications to ensure proper server deployment and integration.

What deployment models are available for an MCP server?

MCP server deployment models include remote HTTP, MCPB, local stdio, and MCP app widgets. The appropriate model is determined by analyzing your specific use case requirements and how the server will be accessed by Claude or other MCP clients.

What is the best way to design tools for an MCP server?

Designing MCP server tools involves selecting an appropriate tool-design pattern, such as one tool per action or search plus execute. The optimal pattern is determined by analyzing your specific use case requirements and the complexity of the actions your server needs to expose.

Which framework should I use for MCP server development?

Recommended frameworks for MCP server development include the Official TypeScript SDK and FastMCP 3.x. The framework is selected after evaluating your deployment model and tool-design pattern requirements during the discovery phase.

Do I need to know MCP specifications to use a scaffolding tool?

Yes, building an MCP server requires knowledge of Claude's constraints and MCP specifications. The guidance skill helps navigate these requirements during the discovery and scaffolding phases, but foundational understanding is necessary for proper implementation.