Skip to content

[pull] main from modelcontextprotocol:main #143

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pull merged 4 commits into from
Nov 20, 2025
Merged

[pull] main from modelcontextprotocol:main #143

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
418b7f9
feat: zod v4 with backwards compatibility for v3.25+ (#1040)
dclark27 Nov 19, 2025
8eb2bea
fix: remove pnpm lock and regenerate package-lock (#1138)
mattzcarey Nov 19, 2025
8acd838
docs: update installation instructions for zod peer dependency (#1139)
mattzcarey Nov 19, 2025
9438478
Implement SEP-1577 - Sampling With Tools (#1101)
ochafik Nov 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 10 additions & 8 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,9 +47,11 @@ The Model Context Protocol allows applications to provide context for LLMs in a
## Installation

```bash
npm install @modelcontextprotocol/sdk
npm install @modelcontextprotocol/sdk zod
```

This SDK has a **required peer dependency** on `zod` for schema validation. The SDK internally imports from `zod/v4`, but maintains backwards compatibility with projects using Zod v3.25 or later. You can use either API in your code by importing from `zod/v3` or `zod/v4`:

## Quick Start

Let's create a simple MCP server that exposes a calculator tool and some data. Save the following as `server.ts`:
Expand All @@ -58,7 +60,7 @@ Let's create a simple MCP server that exposes a calculator tool and some data. S
import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
import * as z from 'zod/v4';

// Create an MCP server
const server = new McpServer({
Expand Down Expand Up @@ -130,7 +132,7 @@ app.listen(port, () => {
});
```

Install the deps with `npm install @modelcontextprotocol/sdk express zod@3`, and run with `npx -y tsx server.ts`.
Install the deps with `npm install @modelcontextprotocol/sdk express zod`, and run with `npx -y tsx server.ts`.

You can connect to it using any MCP client that supports streamable http, such as:

Expand Down Expand Up @@ -477,7 +479,7 @@ MCP servers can request LLM completions from connected clients that support samp
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
import * as z from 'zod/v4';

const mcpServer = new McpServer({
name: 'tools-with-sample-server',
Expand Down Expand Up @@ -561,7 +563,7 @@ For most use cases where session management isn't needed:
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
import * as z from 'zod/v4';

const app = express();
app.use(express.json());
Expand Down Expand Up @@ -796,7 +798,7 @@ A simple server demonstrating resources, tools, and prompts:

```typescript
import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
import { z } from 'zod';
import * as z from 'zod/v4';

const server = new McpServer({
name: 'echo-server',
Expand Down Expand Up @@ -866,7 +868,7 @@ A more complex example showing database integration:
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import sqlite3 from 'sqlite3';
import { promisify } from 'util';
import { z } from 'zod';
import * as z from 'zod/v4';

const server = new McpServer({
name: 'sqlite-explorer',
Expand Down Expand Up @@ -961,7 +963,7 @@ If you want to offer an initial set of tools/prompts/resources, but later add ad
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
import express from 'express';
import { z } from 'zod';
import * as z from 'zod/v4';

const server = new McpServer({
name: 'Dynamic Example',
Expand Down
Loading
Loading