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 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, Hono, Node.js HTTP)
• Runnable examples (under examples/)

This monorepo publishes split packages:

• @modelcontextprotocol/server: build MCP servers
• @modelcontextprotocol/client: build MCP clients

Both packages have a required peer dependency on zod for schema validation. The SDK internally imports from zod/v4, but remains compatible with projects using Zod v3.25+.

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/hono: Hono helpers (app defaults + JSON body parsing hook + Host header validation)

npm install @modelcontextprotocol/server zod

npm install @modelcontextprotocol/client zod

The SDK also publishes optional “middleware” packages that help you wire MCP into a specific runtime or web framework (for example Express, 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.

# Node.js HTTP (IncomingMessage/ServerResponse) Streamable HTTP transport:
npm install @modelcontextprotocol/node

# Express integration:
npm install @modelcontextprotocol/express express

# Hono integration:
npm install @modelcontextprotocol/hono hono

The runnable examples live under examples/ and are kept in sync with the docs.

1. Install dependencies (from repo root):

pnpm install

2. Run a Streamable HTTP example server:

pnpm --filter @modelcontextprotocol/examples-server exec tsx src/simpleStreamableHttp.ts

Alternatively, from within the example package:

cd examples/server
pnpm tsx src/simpleStreamableHttp.ts

3. Run the interactive client in another terminal:

pnpm --filter @modelcontextprotocol/examples-client exec tsx src/simpleStreamableHttp.ts

Alternatively, from within the example package:

cd examples/client
pnpm tsx src/simpleStreamableHttp.ts

Next steps:

• Server examples index: examples/server/README.md
• Client examples index: examples/client/README.md
• Guided walkthroughs: docs/server.md and docs/client.md

• Local SDK docs:
  • docs/server.md – building MCP servers, transports, tools/resources/prompts, CORS, DNS rebinding, and deployment patterns.
  • docs/client.md – using the high-level client, transports, backwards compatibility, and OAuth helpers.
  • docs/capabilities.md – sampling, elicitation (form and URL), and experimental task-based execution.
  • docs/faq.md – environment and troubleshooting FAQs (including Node.js Web Crypto support).
• External references:
  • Model Context Protocol documentation
  • MCP Specification
  • Example Servers

If you are using the v1 generation of the SDK, the v1 documentation (and any v1-specific fixes) live on the long-lived v1.x branch. See: https://github.com/modelcontextprotocol/typescript-sdk/tree/v1.x.

Issues and pull requests are welcome on GitHub at https://github.com/modelcontextprotocol/typescript-sdk.

This project is licensed under the Apache License 2.0 for new contributions, with existing code under MIT. See the LICENSE file for details.