build-mcp-server

Build an MCP server exposing tools to Claude with deployment and tool pattern guidance.

28|5|Updated Jun 24, 2025
One-click install
npx skills add https://github.com/thevibeworks/claude-code-docs --skill build-mcp-server-thevibeworks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-mcp-server
Source: https://github.com/thevibeworks/claude-code-docs/tree/main/content/github/claude-plugins-official/plugins/mcp-server-dev/skills/build-mcp-server
Command: npx skills add https://github.com/thevibeworks/claude-code-docs --skill build-mcp-server-thevibeworks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you avoid painful rework by guiding you through the right choices for building an MCP server that Claude can use effectively.

Core Features & Use Cases

  • Use-case discovery first: interviews the target connections, audience, action count, required UI/inputs, and upstream auth so the design matches reality.
  • Correct deployment recommendation: selects the most suitable MCP deployment model (remote streamable-HTTP, elicitation, MCP app, MCPB, or local stdio).
  • Tool-design guidance: chooses a tool pattern (one tool per action vs search + execute) to keep schemas understandable and performant.

Quick Start

Ask an AI to guide you through building an MCP server for exposing your cloud API to Claude, including the questions needed to choose between remote HTTP, MCP app widgets, or MCPB.

Frequently Asked Questions about build-mcp-server

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

FAQPage Schema
How do I design an MCP server for Claude to expose my API?

To design an MCP server for Claude, you first identify target connections, audience, and required UI inputs. The skill then guides you through selecting the correct deployment model and tool pattern to ensure Claude can effectively use your SaaS API.

Can I use remote HTTP for an MCP server with OAuth authentication?

Yes, remote streamable-HTTP is one of the supported MCP deployment models for Claude integration. It is selected when your use case requires remote connections, often paired with OAuth and structured elicitation for upstream authentication.

What is the best way to structure tool schemas for an MCP server?

The best way to structure MCP tool schemas is choosing between a one tool per action pattern or a search and execute pattern. This decision keeps schemas understandable and performant based on your specific action count.

Does building an MCP server support local filesystem and desktop app integrations?

Yes, building an MCP server supports local filesystem and desktop app integrations. The design process evaluates your specific integration scenario and recommends local stdio or other appropriate deployment models for desktop environments.

When should I use MCPB or MCP app widgets instead of a standard MCP server?

You should use MCPB or MCP app widgets when your MCP server requires rich UI widgets or structured elicitation. The design process evaluates these requirements during use case discovery to determine if they are necessary.

How does an MCP server handle structured elicitation for Claude?

An MCP server handles structured elicitation by utilizing specific deployment models like MCP app widgets. This allows Claude to gather complex user inputs and interact with rich UI components during tool execution.