MCP Client for Testing

@piebro

Repository

Basic information

About MCP Client for Testing

A simple MCP (Model Context Protocol) client for testing MCP Server

#testing #mcp #mcp-client

MCP Client for Testing config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-client-for-testing": {
      "command": "uvx",
      "args": [
        "mcp-client-for-testing",
        "\\"
      ]
    }
  }
}

MCP Client for Testing tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MCP Client for Testing?

MCP Client for Testing is a minimalistic client for testing tool calls in MCP (Model Context Protocol) servers. It is intended for developers who need to verify tool calls during MCP server development.

How to use MCP Client for Testing?

Install uv, then invoke from the command line using uvx mcp-client-for-testing with a JSON configuration and tool call definition. Alternatively, install the Python package and use the execute_tool function from mcp_client_for_testing.client in your own code. Command line flags allow setting client and server log levels.

Key features of MCP Client for Testing

Minimalistic design focused on testing tool calls
CLI invocation via uvx with JSON configuration
Python API for integration into test suites
Configurable client and server log levels
Works with any MCP server that can be launched as a subprocess
Supports passing environment variables to the server process

Use cases of MCP Client for Testing

Testing tool calls in a custom MCP server during development
Verifying tool call parameters, execution, and return values
Quick smoke tests using an echo MCP server
Debugging server configuration and environment settings
Automating tool call verification in CI pipelines

Frequently asked questions

What are the runtime requirements?

The client requires uv to be installed on the system. The server specified in the configuration must also be runnable from the command line.

How do I test a tool call?

Provide a JSON configuration with the server name, command, arguments, and environment, plus a `--tool_call` JSON specifying the tool name and its arguments.

Can I use it in my own Python code?

Yes. Install the package with `uv pip install mcp-client-for-testing` and import `execute_tool` from `mcp_client_for_testing.client` for async usage.

Is there an example server to test with?

Yes, the echo-mcp-server-for-testing server can be used with `uvx` to quickly verify the client works.

How do I configure logging?

Use the `--client_log_level` and `--server_log_level` flags with standard logging levels such as WARNING and INFO.

Comments

More Other MCP servers

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w