MCP Test Client
@willccbb
About MCP Test Client
An MCP Server that's also an MCP Client. Useful for letting Claude develop and test MCPs without needing to reset the application.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-client-server": {
"command": "node",
"args": [
"dist/test-runner.js"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is MCP Test Client?
MCP Test Client is a middleware tool that acts as both an MCP server (to Claude) and an MCP client (to servers under test), enabling developers to test MCP servers during development without registering them directly with Claude.
How to use MCP Test Client?
Install dependencies with npm install, build with npm run build, then either register the server with Claude via the claude-mcp-local script and use its exposed tools, or run the CLI interface with npm run test for an interactive testing menu.
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
- Test servers before formal registration with Claude
Use cases of MCP Test Client
- Develop and debug an MCP server in isolation before registration
- Deploy a server to a staging environment and call its tools
- Run end-to-end test suites against deployed servers
- Inspect server logs during development to fix issues
- Iterate on server code and redeploy quickly without affecting production
FAQ from MCP Test Client
What is MCP Test Client used for?
It is used to test MCP servers during development by acting as a bridge between Claude and the server under test.
How do I install the MCP Test Client?
Run npm install to install dependencies and npm run build to compile the TypeScript project.
How do I register the MCP Test Client with Claude?
The server is registered with Claude via the claude-mcp-local script (details are in the project’s usage instructions).
What transport does MCP Test Client use?
It implements a custom transport for stdio communication with the servers being tested.
What are the main tools provided by MCP Test Client?
The tools include mcp_test_deploy_server, mcp_test_call_tool, mcp_test_run_tests, mcp_test_get_logs, mcp_test_list_servers, and mcp_test_stop_server.
Frequently asked questions
What is MCP Test Client used for?
It is used to test MCP servers during development by acting as a bridge between Claude and the server under test.
How do I install the MCP Test Client?
Run `npm install` to install dependencies and `npm run build` to compile the TypeScript project.
How do I register the MCP Test Client with Claude?
The server is registered with Claude via the `claude-mcp-local` script (details are in the project’s usage instructions).
What transport does MCP Test Client use?
It implements a custom transport for stdio communication with the servers being tested.
What are the main tools provided by MCP Test Client?
The tools include `mcp_test_deploy_server`, `mcp_test_call_tool`, `mcp_test_run_tests`, `mcp_test_get_logs`, `mcp_test_list_servers`, and `mcp_test_stop_server`.
Basic information
More Developer Tools MCP servers
Hello World MCP Server (Reference Extension)
anthropicsDesktop Extensions: One-click local MCP server installation in desktop apps
Serena
oraiosA powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent
BetterBugs
BetterBugsThe BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C
TaskerArmy Agent
TaskerArmyAsk Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.
Air Pipe
airpipeBuild, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.
Comments