skills.rest
julianobarbosa
julianobarbosaCOMMUNITY
Explore all skills by this author →
Website𝕏@julianobarbosaGitHub

build-mcp-server

Guide MCP server design and scaffold for Claude deployments.

Updated Aug 23, 2026
Search Tags:#mcp#tool design#claude integration#server scaffolding#api wrapping#oauth deployment
One-click install
npx skills add https://github.com/julianobarbosa/.claude --skill build-mcp-server-julianobarbosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-mcp-server
Source: https://github.com/julianobarbosa/.claude/tree/main/plugins/marketplaces/claude-plugins-official/plugins/mcp-server-dev/skills/build-mcp-server
Command: npx skills add https://github.com/julianobarbosa/.claude --skill build-mcp-server-julianobarbosa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Build an MCP server that works smoothly with Claude by guiding you through the right early architectural decisions, instead of wasting time on rewrites after scaffolding the wrong shape.

Core Features & Use Cases

  • Use-case discovery first: Interrogates your upstream connection, audience, action count, UI needs, and auth requirements before generating any server code.
  • Deployment model recommendation: Chooses the best MCP server form (remote streamable HTTP, elicitation-based forms, MCP app widgets, MCPB local server, or local stdio for prototypes).
  • Tooling design guidance: Selects a tool pattern (one tool per action vs search + execute) based on the size and complexity of the action surface.
  • Framework and handoff: Recommends either the official TypeScript SDK or FastMCP, then delegates to the appropriate specialized skill to finish scaffolding.
  • Claude compatibility guardrails: Instructs fetching Claude-specific connector documentation so guidance matches Claude’s actual constraints.

Quick Start

Ask the skill: build an MCP server for wrapping my SaaS REST API with OAuth, exposing about 60 actions, and using a simple search-and-run pattern.

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 and scaffold an MCP server for Claude?▼

To design and scaffold an MCP server for Claude, you first define your use case, then select a deployment model like remote HTTP or stdio, choose a tool pattern, and receive a framework recommendation for scaffolding.

What deployment model should I use when building an MCP server?▼

The deployment model for an MCP server depends on your requirements: use remote streamable HTTP for cloud APIs, elicitation-based forms for UI needs, MCPB for local servers, or stdio for local prototypes.

How do I wrap a REST API with OAuth for Claude tool use?▼

Wrapping a REST API with OAuth for Claude involves choosing a tool-design pattern like search-and-run, selecting the appropriate framework such as the TypeScript SDK or FastMCP, and scaffolding the deployment model.

How many actions should an MCP server expose to Claude?▼

The number of actions an MCP server exposes to Claude determines your tool-design pattern: use one tool per action for smaller surfaces, or a search-and-execute pattern for larger, more complex action sets.

Does the MCP server scaffolding process check Claude integration constraints?▼

Yes, the MCP server scaffolding process fetches Claude-specific connector documentation to ensure that your tool surface and deployment model align with Claude’s actual integration constraints.

When should I avoid using remote streamable HTTP for an MCP server?▼

You should avoid remote streamable HTTP for an MCP server when building local prototypes or simple integrations, instead using local stdio or an MCPB local server to reduce architectural overhead.

Related Skills

Explore More Software Engineering Skills→
SOLEROMSOLEROM

build-mcp-server

Design MCP servers by evaluating use-case and deployment options.

Community
Intermediate
onelee85onelee85

build-mcp-server

Guide MCP server design and scaffolding for Claude integration.

Community
Advanced
thevibeworksthevibeworks
28

build-mcp-server

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

Official
Advanced
TNHoang2708TNHoang2708
1

ck:mcp-builder

Build MCP servers with FastMCP and MCP SDK for external service integration.

Community
Advanced