MCP Testing Kit

@thoughtspot

Repository

Basic information

About MCP Testing Kit

The testing library you need to test your MCP servers

MCP Testing Kit config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

MCP Testing Kit 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-testing-kit?

mcp-testing-kit is a lightweight TypeScript testing library that provides utilities to connect to an MCP server instance, send requests, receive notifications, and assert server behavior. It works with any testing framework (vitest, jest, etc.) and is designed for developers who need to test Model Context Protocol (MCP) servers.

How to use mcp-testing-kit?

Install as a dev dependency using npm i -D mcp-testing-kit. Import the connect and close functions, create an MCP server instance, call connect(server) to get a mock client, use the client methods (e.g., callTool, listTools) to interact with the server, and call close(server) to clean up after each test.

Features of mcp-testing-kit

Works with any testing framework (vitest, jest, etc.)
Lightweight, provides "just enough" utilities to test an MCP server
Full TypeScript support
Direct transport layer (no HTTP/SSE dependency)

Use cases of mcp-testing-kit

Unit testing MCP server tools, resources, and prompts
Verifying server responses to JSON-RPC requests
Integration testing without setting up an actual network transport
Automating server behavior assertions in CI pipelines

Frequently asked questions

What testing frameworks does mcp-testing-kit support?

It works with any testing framework, such as vitest, jest, and others.

Does it require running an actual MCP server over HTTP/SSE?

No. It creates a dummy transport layer that connects directly to the MCP server instance, bypassing HTTP/SSE.

What methods are available on the returned client?

The `connect` function returns a client with methods: `listTools`, `callTool`, `listResources`, `listPrompts`, `getPrompt`, `onNotification`, `onError`, `onProgress`, and `sendToServer`.

How do I clean up after a test?

Use the `close(server)` function to close the MCP server instance, typically in an `afterEach` hook.

Is mcp-testing-kit written in TypeScript?

Yes, it is built with TypeScript and provides type definitions.

Comments

More Developer Tools MCP servers

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

Final POS – Custom POS Builder

Final Commerce

Build custom POS apps with your AI agent. Final's MCP server lets developers scaffold checkout flows, adapt vetted screen blueprints for counter POS, self-checkout kiosks, restaurant ordering and payment terminals, previ

Jaybird Digital

Steve Wheeler

Jaybird Digital lets you build a website for you in the conversation. Tell your ai about your business and what you want, and it writes the pages and saves them to Jaybird. You get a link to view the site right away, wi

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.