The MCP TypeScript SDK provides server and client packages for the Model Context Protocol, with v2 branch documentation and multi-runtime runtime support. It publishes server, client, and optional middleware packages and includes examples and docs for setup and usage.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
The repository contains the TypeScript SDK implementation for the Model Context Protocol (MCP). It runs on Node.js, Bun, and Deno, and ships server libraries, client libraries, optional middleware packages, and runnable examples. The monorepo publishes split packages: @modelcontextprotocol/server and @modelcontextprotocol/client, plus optional middleware packages under packages/middleware (e.g., @modelcontextprotocol/node, @modelcontextprotocol/express, @modelcontextprotocol/fastify, @modelcontextprotocol/hono).
How it works
The SDK provides:
- Server libraries to expose MCP tools and transports (e.g., stdio, HTTP, auth helpers).
- Client libraries for MCP transports and higher-level helpers, including OAuth helpers.
- Middleware packages that integrate MCP into specific runtimes/frameworks.
- Examples under
examples/and documentation sites for v2, including an API reference and MCP documentation.
The README notes the v2 release line aligned with the 2026-07-28 MCP spec and mentions v1.x will receive bug fixes for at least 6 months after v2 release.
Getting started
Installation commands from the README:
npm install @modelcontextprotocol/server
# or
bun add @modelcontextprotocol/server
# or
deno add npm:@modelcontextprotocol/server
npm install @modelcontextprotocol/client
# or
bun add @modelcontextprotocol/client
# or
deno add npm:@modelcontextprotocol/client
Optional middleware packages installation examples:
```bash
# Node.js HTTP (IncomingMessage/ServerResponse) Streamable HTTP transport:
npm install @modelcontextprotocol/node
# Express integration:
npm install @modelcontextprotocol/express express
# Fastify integration:
npm install @modelcontextprotocol/fastify fastify
# Hono integration:
npm install @modelcontextprotocol/hono hono
Documentation and getting started content
The README provides links to:
- v2 documentation site: https://ts.sdk.modelcontextprotocol.io/v2/
- server/client tutorials and examples via docs/get-started/first-server.md and first-client.md
- runnable examples under
examples/and adocs/section for API reference and troubleshooting.
Releases
The latest release listed is 1.30.0 (2026-07-27) with changes focusing on server formatting of issues and CI publish flow, plus related 2.0.0 minor changes across server, server-legacy, node, and hono packages. Specific release notes are present in the README under RELEASES, showing combined changes for multiple packages.
Traction
The repository shows 13059 stars, 2047 forks, and 537 open issues.