MCP Test Client

@crazyrabbitLTC

Repository

Basic information

About MCP Test Client

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

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

MCP Test Client config

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

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

MCP Test Client 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.

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

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

More Developer Tools MCP servers

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

offprompt

MCP server that lets Claude Code, Cursor or Codex ask you for API keys on a local page and write them to .env. The agent only ever sees key names.

Official Porkbun MCP Server

Porkbun LLC

Official Porkbun MCP server, maintained by Porkbun. Check domain availability and pricing, register, renew and transfer domains, and manage DNS records, nameservers, URL forwarding, glue records, DNSSEC and domain contac