Skip to content

Add ergonomic test client for testing MCP servers #1728

@maxisbey

Description

@maxisbey

Summary

Provide a dedicated test client that simplifies testing MCP servers without the boilerplate of manually setting up transports, streams, and context managers.

Motivation

Currently, testing an MCP server requires:

  • Setting up stdio_client or similar transport
  • Managing multiple nested context managers (transport + session)
  • Wiring up memory streams manually

This creates friction for both SDK users writing tests for their servers and for the SDK's own test suite.

Goal

Something analogous to FastAPI's TestClient / Starlette's test client pattern - a simple way to instantiate a client against a server instance and make requests without transport ceremony.


AI Disclaimer

Metadata

Metadata

Labels

P1Significant bug affecting many users, highly requested featureenhancementRequest for a new feature that's not currently supportedv2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions