modelcontextprotocol/typescript-sdk

> [!IMPORTANT]
> This is the main branch: v2 of the SDK (@modelcontextprotocol/server, @modelcontextprotocol/client), the stable release line, implementing the 2026-07-28 MCP spec. Start with the v2 documentation; coming from v1, see the migration guide.
> v1.x (@modelcontextprotocol/sdk) lives on the v1.x branch and continues to receive bug fixes and security updates for at least six months after the v2 release (2026-07-27). Its documentation is at ts.sdk.modelcontextprotocol.io.
> Found a problem in v2? Open an issue.
> [!NOTE]
> Contributors without write access can have one open pull request at a time. Draft pull requests don't count toward the limit. For a feature or a larger change, please open an issue first; see CONTRIBUTING.md.
Table of Contents
Overview
Packages
Installation
Getting Started
Documentation
Contributing
License
## Overview
The Model Context Protocol (MCP) allows applications to provide context for LLMs in a standardized way, separating the concerns of providing context from the actual LLM interaction.
This repository contains the TypeScript SDK implementation of the MCP specification. It runs on Node.js, Bun, and Deno, and ships:
MCP server libraries (tools/resources/prompts, Streamable HTTP, stdio, auth helpers)
MCP client libraries (transports, high-level helpers, OAuth helpers)
Optional middleware packages for specific runtimes/frameworks (Express, Fastify, Hono, Node.js HTTP)
Runnable examples (under examples/)
## Packages
This monorepo publishes split packages:
@modelcontextprotocol/server: build MCP servers
@modelcontextprotocol/client: build MCP clients
Tool and prompt schemas use Standard Schema — bring Zod v4, Valibot, ArkType, or any compatible library.
### Middleware packages (optional)
The SDK also publishes small "middleware" packages under packages/middleware/ that help you wire MCP into a specific runtime or web framework.
They are intentionally thin adapters: they should not introduce new MCP functionality or business logic. See packages/middleware/README.md for details.
@modelcontextprotocol/node: Node.js Streamable HTTP transport wrapper for IncomingMessage / ServerResponse
@modelcontextprotocol/express: Express helpers (app defaults + Host header validation)
@modelcontextprotocol/fastify: Fastify helpers (app defaults + Host header validation)
@modelcontextprotocol/hono: Hono helpers (app defaults + JSON body parsing hook + Host header validation)
## Installation
### Server
bash
npm install @modelcontextprotocol/server
# or
bun add @modelcontextprotocol/server
# or
deno add npm:@modelcontextprotocol/server
### Client
bash
npm install @modelcontextprotocol/client
# or
bun add @modelcontextprotocol/client
# or
deno add npm:@modelcontextprotocol/client
### Optional middleware packages
The SDK also publishes optional “middleware” packages that help you wire MCP into a specific runtime or web framework (for example Express, Fastify, Hono, or Node.js http).
These packages are intentionally thin adapters and should not introduce additional MCP features or business logic. See packages/middleware/README.md for details.
bash
# Node.js HTTP (IncomingMessage/ServerResponse) Streamable HTTP transport: