Mcp Server Patterns

A straightforward reference for building MCP servers with the Node/TypeScript SDK. Covers the essentials: registering tools, resources, and prompts with Zod validation, plus when to use stdio (Claude Desktop) versus Streamable HTTP (Cursor, cloud). The SDK API has changed over time, so the skill wisely tells you to check Context7 or the official docs for current method signatures rather than cargo culting old patterns. Useful if you're spinning up a new server or debugging why your tools aren't registering. Includes best practices on schema design, error handling, and idempotency that save you from common mistakes.

skills.sh installs: 4.6K
GitHub stars: 229.1K
last updated: Jul 14, 2026

View on GitHub

Install

$ npx -y skills add affaan-m/everything-claude-code --skill mcp-server-patterns --agent claude-code

Installs into .claude/skills of the current project.

Files

MCP Server Patterns

The Model Context Protocol (MCP) lets AI assistants call tools, read resources, and use prompts from your server. Use this skill when building or maintaining MCP servers. The SDK API evolves; check Context7 (query-docs for "MCP") or the official MCP documentation for current method names and signatures.

For the broader routing decision of when a capability should be a rule, a skill, MCP, or a plain CLI/API workflow, see docs/capability-surface-selection.md.

When to Use

Use when: implementing a new MCP server, adding tools or resources, choosing stdio vs HTTP, upgrading the SDK, or debugging MCP registration and transport issues.