@modelcontextprotocol/server

@modelcontextprotocol/server

The MCP (Model Context Protocol) TypeScript server SDK. Build MCP servers that expose tools, resources, and prompts.

[!WARNING] This is an alpha release. Expect breaking changes until v2 stabilizes. We're publishing early to gather feedback — please try it and open issues — but we can't guarantee API stability yet. We'll aim to minimize disruption between alphas.

[!NOTE] This is v2 of the MCP TypeScript SDK. It replaces the monolithic @modelcontextprotocol/sdk package from v1. See the migration guide if you're coming from v1.

Install

npm install @modelcontextprotocol/server@alpha

TypeScript ≥6.0 no longer auto-includes @types/* — add "types": ["node"] to your tsconfig.json compilerOptions (the published .d.mts references Buffer).

Optional framework adapters: @modelcontextprotocol/express, @modelcontextprotocol/hono, @modelcontextprotocol/node.

Documentation

• Repository README — overview, package layout, examples
• Server guide — tools, resources, prompts, and the rest of the server surface
• Serving guide — stdio, HTTP, the framework adapters, sessions, and authorization
• API reference
• MCP specification