MCP.so
Sign In

MCP Test Client

@crazyrabbitLTC

Repository

About MCP Test Client

MCP Test Client is a TypeScript testing utility for Model Context Protocol (MCP) servers.

#mcp-test-client#testing-utility#typescript

Config

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

{
  "mcpServers": {
    "mcp-test-client": {
      "command": "bun",
      "args": [
        "test"
      ]
    }
  }
}

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?

A testing utility for Model Context Protocol (MCP) servers. It helps developers test MCP server implementations by providing a simple interface for making tool calls and validating responses.

How to use MCP Test Client?

Install it with bun install mcp-test-client, then import MCPTestClient, configure it with your server command and arguments, call init(), and use methods like listTools() or assertToolCall(). The package includes a mock calculator server for learning and testing.

Key features of MCP Test Client

  • Easy-to-use testing interface for MCP servers
  • Built-in support for tool listing and calls
  • Type-safe implementation using TypeScript
  • Assertion utilities for validating responses
  • Mock calculator server included for examples

Use cases of MCP Test Client

  • Test that your MCP server lists expected tools
  • Validate tool call results with custom assertions
  • Learn MCP tool operations using the provided calculator mock
  • Automate server testing in a CI pipeline
  • Debug server behavior without a production client

FAQ from MCP Test Client

What are the prerequisites?

Bun runtime v1.0.0 or higher is required.

How do I install MCP Test Client?

Run bun install mcp-test-client in your project.

How do I run the included tests?

After installing dependencies with bun install, execute bun test in the repository root.

What does the package include out of the box?

The MCPTestClient class with methods for listing tools, calling tools, and asserting results, plus a mock calculator server in ./tests/mocks/calculator.ts.

Is MCP Test Client open source?

Yes, it is released under the MIT license.

Frequently asked questions

What are the prerequisites?

Bun runtime v1.0.0 or higher is required.

How do I install MCP Test Client?

Run `bun install mcp-test-client` in your project.

How do I run the included tests?

After installing dependencies with `bun install`, execute `bun test` in the repository root.

What does the package include out of the box?

The `MCPTestClient` class with methods for listing tools, calling tools, and asserting results, plus a mock calculator server in `./tests/mocks/calculator.ts`.

Is MCP Test Client open source?

Yes, it is released under the MIT license.

Comments

Basic information

Category

Developer Tools

Transports

stdio

Author

crazyrabbitLTC

More Developer Tools MCP servers

Agent Conductor

icohangar-ops

Agent conductor — AGENTS.md contract parser, SKILL.md registry, CHP decision engine over MCP

directree

coburn2716

directree MCP server — query the honest software directory from any AI assistant

Repo Test Architect

RepoAssay

Local-first, read-only MCP server for evidence-backed repository test architecture audits and test planning.

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

1

Skycloak

Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.