mcp-client-server

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.

121
7

MCP Test Client

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.

Architecture

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.

Features

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.

Implementation

Implemented using process management, the official MCP SDK, a custom transport for stdio communication, test execution, and a CLI interface.

Installation & Usage

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.

Development Workflow & Future Enhancements

The client facilitates iterative development and testing before formal registration. Future enhancements include Docker-based container management and comprehensive test suites.

Repository

WI
willccbb

willccbb/mcp-client-server

Created

March 10, 2025

Updated

March 28, 2025

Language

TypeScript

Category

Developer Tools