mcp-test-client

MCP.Pizza Chef: crazyrabbitLTC

MCP Test Client is a TypeScript-based testing utility designed specifically for Model Context Protocol (MCP) servers. It provides a straightforward interface to facilitate testing MCP server implementations by enabling easy tool listing, tool calls, and response validation. The client includes type-safe features and assertion utilities to ensure robust testing workflows. Additionally, it offers a mock calculator server example to demonstrate usage. This client streamlines the development and verification of MCP servers, making it an essential tool for developers working with MCP integrations.

Unmaintained · No commits in 20 months.

Use This MCP client To

Test MCP server tool listing functionality Validate MCP server tool call responses Perform type-safe MCP server integration tests Mock MCP server behavior for testing Automate MCP server response assertions

README

MCP Test Client

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

Features

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

Installation

bun install mcp-test-client

Usage

Basic Example

mcp-test-client FAQ

How do I install the MCP Test Client?

You can install it using Bun with the command `bun install mcp-test-client`.

What programming language is MCP Test Client written in?

It is implemented in TypeScript, providing type safety and modern development features.

Can MCP Test Client run and manage MCP server processes?

Yes, it can start your MCP server using specified commands and arguments, then interact with it for testing.

Does MCP Test Client support validating server responses?

Yes, it includes assertion utilities to help validate the correctness of MCP server responses.

Is there an example server included for testing?

Yes, a mock calculator server implementation is provided as an example to demonstrate usage.

Can MCP Test Client be used with different MCP servers?

Yes, it is designed to test any MCP server implementation by making tool calls and validating responses.

How does MCP Test Client help with tool calls?

It provides built-in support for listing available tools and making calls to those tools on the MCP server.

Is MCP Test Client compatible with multiple LLM providers?

While it focuses on MCP servers, it can be used in environments with OpenAI, Claude, Gemini, and other LLM providers by testing the MCP server layer.