The MCP Test Client is a middleware that acts as both a server for Claude and a client for MCP servers under test, enabling testing and development without direct registration.
The MCP Test Client is a middleware designed for testing MCP servers during development. It acts as both a server, registered with Claude and exposing testing tools, and a client, connecting to and testing MCP servers under development.
The client allows testing of MCP servers without direct registration with Claude. It interacts with Claude, exposing tools, and simultaneously functions as a client to the server under test.
Key features include deploying MCP servers to test environments, calling individual tools with custom arguments, running automated test suites, viewing server logs, and testing servers before formal registration with Claude.
Implemented using process management, the official MCP SDK, a custom transport for stdio communication, test execution, and a CLI interface.
Installation involves using npm install
and npm run build
. Usage includes deploying servers, calling tools, running tests, and viewing logs via the provided CLI or direct tool calls.
The client facilitates iterative development and testing before formal registration. Future enhancements include Docker-based container management and comprehensive test suites.
willccbb/mcp-client-server
March 10, 2025
March 28, 2025
TypeScript