MCP Test

Provides an STDIO-based MCP tester to verify connections, capabilities, and tool calls for MCP Servers.

typescript

1

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "peterpan-mu-mcp-test": {
      "command": "npx",
      "args": [
        "-y",
        "github:Peterpan-MU/MCP-Test"
      ],
      "env": {
        "API_KEY": "your_key"
      }
    }
  }
}

You can run a dedicated MCP Server Tester to validate and troubleshoot other MCP Servers using STDIO mode. It helps you verify connections, discover capabilities, test specific tools, and view clear, structured test reports, all from a local or remote setup.

How to use

Use the MCP Server Tester from your MCP client to run tests against target MCP Servers. You can perform a connection test to ensure the server starts and responds, discover all available tools, resources, and prompts, run a specific tool call, and review a neatly formatted test report of steps and results. Start by configuring the tester as an MCP server in your client, then invoke the test commands you need to validate your target MCP Server.

How to install

Prerequisites: Node.js (v18 or newer) and npm must be available on your system.

Install and run the tester directly from GitHub without a local install using npx.

{
  "mcpServers": {
    "mcp_tester": {
      "command": "npx",
      "args": ["-y", "github:Peterpan-MU/MCP-Test"]
    }
  }
}

If you prefer a local installation, clone the project, install dependencies, and build.

# Clone the repository
git clone https://github.com/Peterpan-MU/MCP-Test.git
cd MCP-Test

# Install dependencies
npm install

# Build the project
npm run build

Additional setup options

There are multiple ways to configure the tester as an MCP server in your client. The following examples show common, explicit configurations you can reuse.

Temporary/alternative run modes

You can also run tests directly with npm when installed locally, or use a local development path for testing.

Available tools

test_server_connection

Test basic connection capabilities of a target MCP Server by launching the server process with given command, arguments, and environment variables, and reporting the connection status and initialization result.

test_server_capabilities

Comprehensively test all capabilities of a target MCP Server, including tools, resources, and prompts, with a full capability report.

test_tool_call

Test invoking a specific tool on the target MCP Server, including tool name, arguments, and outcome of the call.