MCP Test Client
@crazyrabbitLTC
About MCP Test Client
MCP Test Client is a TypeScript testing utility for Model Context Protocol (MCP) servers.
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.
Basic information
More Developer Tools MCP servers
MCP Containers
metorialConnect any AI model to 1200+ integrations (MCP, CLI, API)
Deepwiki MCP Server
regenrek📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors
Unity MCP (Server + Plugin)
IvanMurzakAI 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
AptiBuild AI — Career Intelligence
ParklandBuildsAptiBuild AI MCP Server — career, labor market, and business idea intelligence for AI agents. 11 tools covering real-time FRED labor market signals, BLS wage data (126 occupations), AI-generated app ideas, career paths,
endoflife.ai
endoflife.aiFree MCP server for software end-of-life intelligence: EOL dates, support status, and the 0-100 EOL Risk Score across 485 tracked products. Agents can check a single version, pull a product's full lifecycle schedule, or
Comments