Files
Tobin South b00abee24e Align mcp-server-dev skills with claude.com/docs connector guidance (#1418)
- build-mcp-server: load llms-full.txt for Claude-specific context;
  add Phase 6 (test in Claude, review checklist, submit, ship plugin)
- references/auth.md: add Claude auth-type table, callback URL,
  not-supported list
- references/tool-design.md: add Anthropic Directory hard requirements
  (annotations, name length, read/write split, prompt-injection rule)
- build-mcp-app: add Claude host specifics (prefersBorder,
  safeAreaInsets, CSP) and submission asset specs; testing via
  custom connector
- build-mcpb: note remote servers are the recommended directory path
2026-04-17 17:02:48 +01:00
..

mcp-server-dev

Skills for designing and building MCP servers that work seamlessly with Claude.

What's inside

Three skills that compose into a full build path:

Skill Purpose
build-mcp-server Entry point. Interrogates the use case, picks deployment model (remote HTTP / MCPB / local stdio), picks tool-design pattern, routes to a specialized skill.
build-mcp-app Adds interactive UI widgets (forms, pickers, confirm dialogs) rendered inline in chat. Works on remote servers and MCPB bundles.
build-mcpb Packages a local stdio server with its runtime so users can install it without Node/Python. For servers that must touch the local machine.

How it works

build-mcp-server is the front door. It asks what you're connecting to, who'll use it, how big the action surface is, and whether you need in-chat UI. From those answers it recommends one of four paths:

  • Remote streamable-HTTP (the default recommendation for anything wrapping a cloud API) — scaffolded inline
  • MCP app — hands off to build-mcp-app
  • MCPB — hands off to build-mcpb
  • Local stdio prototype — scaffolded inline with an MCPB upgrade note

Each skill ships reference files for the parts that don't fit in the main instructions: auth flows (DCR/CIMD), tool-description writing, widget templates, manifest schemas, security hardening.

Usage

Ask Claude to "help me build an MCP server" and the entry skill will trigger. Or invoke directly:

/mcp-server-dev:build-mcp-server