mcp-server-skills

Links

• Model Context Protocol: https://modelcontextprotocol.io/
• mcp-handler (HTTP): https://www.npmjs.com/package/mcp-handler
• Reference implementation (Roll Dice): https://github.com/gocallum/rolldice-mcpserver
• Claude Desktop + mcp-remote bridge: https://www.npmjs.com/package/mcp-remote

Folder Structure (Next.js App Router)

app/
  api/[transport]/route.ts   # One handler for all transports (e.g., /api/mcp)
  actions/mcp-actions.ts     # Server actions reusing the same logic/schemas
lib/
  dice.ts | tools.ts         # Zod schemas, tool definitions, pure logic
components/                  # UI that calls server actions for web testing

Goal: Keep route.ts minimal. Put logic + Zod schemas in lib/* so both the MCP handler and server actions share a single source of truth.