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

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions