MCP Test Client logo

MCP Test Client

by willccbb

The MCP Test Client is a middleware that acts as both a server (to Claude) and a client (to servers under test). It's designed for testing MCP servers during development without direct registration with Claude.

View on GitHub

Last updated: N/A

What is MCP Test Client?

The MCP Test Client is a dual-role middleware that allows developers to test MCP servers in a controlled environment. It simulates the interaction between Claude and MCP servers, enabling thorough testing before formal registration.

How to use MCP Test Client?

The MCP Test Client can be used both as an MCP server registered with Claude and as a CLI tool. As a server, it exposes tools for deploying, calling tools on, running tests against, viewing logs of, listing, and stopping MCP servers. As a CLI tool, it provides an interactive menu for managing MCP servers.

Key features of MCP Test Client

  • Deploy MCP servers to test environments

  • Call individual tools with custom arguments

  • Run automated test suites

  • View server logs

Use cases of MCP Test Client

  • Testing MCP server functionality during development

  • Debugging MCP server issues in a controlled environment

  • Validating MCP server responses before registration with Claude

  • Automating MCP server testing with test suites

FAQ from MCP Test Client

What is the MCP Test Client?

It's a middleware for testing MCP servers.

How does it work?

It acts as both a server to Claude and a client to the MCP server under test.

What are its main features?

Deploying servers, calling tools, running tests, and viewing logs.

How do I install it?

Use npm install and npm run build.

How do I run it?

Use npm run test or node dist/test-runner.js for the CLI, or register it with Claude using claude-mcp-local.