Upgrade MCP SDK to v1.25.1 #27314
Open
Upgrade MCP SDK to v1.25.1 #27314
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This sync updates the documentation to reflect the following changes from cloudflare/agents PR #752: ## API Changes ### WorkerTransportOptions (mcp-handler-api.mdx) - Added `onsessionclosed` callback that fires when a session is closed via DELETE request - Added `eventStore` option for SSE resumability support, enabling clients to reconnect and resume using Last-Event-ID header - Added `retryInterval` option to control client reconnection timing for polling behavior - Added `closeSSEStream()` method to WorkerTransport class for implementing polling behavior during long-running operations - Updated `sessionIdGenerator` description to clarify it can return undefined for stateless mode ### MCPTransportOptions (mcp-client-api.mdx) - Added `connectionTimeoutMs` option (default: 15000ms) to prevent infinite hangs when connecting to MCP servers. Particularly useful when proxies strip SSE newline terminators. ### New Example (transport.mdx) - Added documentation for the new `mcp-server` example showing how to use `WebStandardStreamableHTTPServerTransport` from the MCP SDK directly without the agents package. This is the simplest way to create stateless MCP servers on Cloudflare Workers. Related PR: cloudflare/agents#752 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
agents-git-bot
bot
requested review from
a team,
elithrar,
irvinebroque,
rita3ko,
thomasgauvin,
threepointone and
whoiskatrin
as code owners
github-actions
bot
added
size/m
product:agents
github-actions
bot
assigned
elithrar,
irvinebroque,
rita3ko,
thomasgauvin,
threepointone and
whoiskatrin
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
This commit documents the new stateless MCP server approach introduced in PR #752 (Upgrade MCP SDK to v1.25.1). Changes: - Add new stateless-mcp-server.mdx guide demonstrating WebStandardStreamableHTTPServerTransport usage - Update MCP index page to explain both stateless and McpAgent-based approaches - Update remote-mcp-server guide to clarify it uses McpAgent and link to stateless option - Document the simplest way to create MCP servers on Cloudflare Workers The new example (examples/mcp-server) uses the MCP SDK directly without the agents package, providing a zero-config stateless option that is simpler for basic use cases. Related PR: cloudflare/agents#752
Contributor
Author
Documentation UpdatesAdded comprehensive documentation for the stateless MCP server approach introduced in cloudflare/agents#752: New Documentation
Updated Documentation
The new stateless approach is documented as "THE simplest way to get started with MCP on Cloudflare" and is ideal for servers that don't need to maintain state between requests. |
Document the MCP SDK upgrade from v1.23.0 to v1.25.1 with the following updates: - Add new section on using MCP SDK directly without Agents SDK - Document the new mcp-server example using WebStandardStreamableHTTPServerTransport - Add documentation for new WorkerTransport options: - onsessionclosed callback for session cleanup - eventStore for connection resumability support - retryInterval for SSE polling behavior control Related to cloudflare/agents#752 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Contributor
- Document new WorkerTransport features: eventStore, onsessionclosed, retryInterval - Highlight new mcp-server example with stateless guide - Explain improved error handling and migration notes Related to cloudflare/agents#752 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Contributor
|
CI run failed: build logs |
|
|
||
| :::note[Looking for a simpler stateless option?] | ||
| If you do not need state management and want the simplest possible MCP server, see the [Build a stateless MCP server](/agents/guides/stateless-mcp-server/) guide. That approach uses the MCP SDK directly without the `McpAgent` wrapper. | ||
| ::: |
Contributor
There was a problem hiding this comment.
Should we make this default?
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
6 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Documents the upgrade of
@modelcontextprotocol/sdkfrom v1.23.0 to v1.25.1 in the Agents SDK.WebStandardStreamableHTTPServerTransportmcp-serverexample that provides the simplest way to create an MCP server on Cloudflare Workersonsessionclosedcallback for session cleanup notificationseventStorefor connection resumability support (allows clients to recover from interruptions)retryIntervalfor controlling SSE polling behaviorTest plan
Related PR: cloudflare/agents#752
🤖 Generated with Claude Code