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

Basic information

Category

Developer Tools

Runtime

node

Transports

stdio

Publisher

crazyrabbitLTC

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.

Comments

More Developer Tools MCP servers

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

test

cloudwego

The ultimate LLM/AI application development framework in Go.

12.2K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K