MCP Test Kit

MCP开发工具

提供方 CrashBytes

开发工具 未标注 无需鉴权 社区 / 第三方 Claude

一个用于Model Context Protocol(MCP)服务器的全面测试框架,提供MCPTestClient、自定义Vitest匹配器和模拟服务器等功能。

一句话选型结论

按资料字段整理

MCP Test Kit 属于开发工具类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

测试框架TypeScript本地部署MCP协议自动化测试工具验证服务器测试

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Test Kit当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方CrashBytes上游标注的维护方 CrashBytes
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.6 KB
来自项目仓库与上游目录的原文,未做删改

MCP测试套件

> 模型上下文协议(MCP)服务器的综合测试框架

📖 目录

  • 什么是MCP?
  • 什么是MCP测试套件?
  • 为什么使用MCP测试套件?
  • 安装
  • 快速开始
  • 核心概念
  • API 参考
  • 例子
  • 最佳实践
  • 贡献
  • 许可证

🤔 什么是MCP?

模型上下文协议(MCP) 是由Anthropic开发的一种开放协议,它使像Claude这样的人工智能助手能够安全地与外部工具、数据源和服务进行交互。将其视为AI模型的一种标准化方式:

  • 访问工具:执行搜索数据库、调用API或运行计算等功能
  • 阅读资源:从文件、数据库或外部服务获取数据
  • 使用提示:利用预构建的提示模板完成常见任务

现实世界MCP示例

以下是您可以构建的一些实用的MCP服务器:

  1. 天气服务器:提供任何城市的当前天气数据
  2. 数据库服务器:允许查询PostgreSQL/MySQL数据库
  3. 文件系统服务器:允许读取/写入磁盘上的文件
  4. API集成服务器:连接到第三方API(GitHub、Slack等)
  5. 计算器服务器:执行复杂的数学运算

MCP的工作原理```mermaid

graph LR
A[Claude
Client] <-->|MCP| B[MCP Server
Your Code]
B <--> C[Your Data
or Service]


MCP服务器充当Claude和您的数据/服务之间的桥梁,通过标准化协议公开它们。

## 🎯 什么是MCP测试套件?

**MCP测试套件** 是一个测试框架,可以轻松为MCP服务器编写自动化测试。它提供:

### 🔧 核心功能

1. **MCPTestClient**:连接到MCP服务器并调用其工具/资源的测试客户端
1. **定制Vitest配对器**:用于验证MCP响应的专门断言
1. **模拟服务器**:创建伪造的MCP服务器以测试客户端代码
1. **TypeScript支持**:完整的类型定义,以获得更好的IDE支持和类型安全

### 🎪 它解决的问题

没有MCP测试套件,测试MCP服务器具有挑战性:

- ❌ 您需要手动启动服务器并与之交互
- ❌ 没有标准化的方法来断言MCP特定的行为
- ❌ 集成测试的复杂设置
- ❌ 难以测试的错误条件和边缘情况

**使用MCP测试套件:**

- ✅ 在测试中以编程方式启动和停止服务器
- ✅ 使用直观的匹配器,如 `toBeValidMCPTool()` 和 `toMatchMCPToolResponse()`
- ✅ 在几分钟内编写全面的集成测试
- ✅ 轻松测试错误处理和边缘情况

## 💡 为什么使用MCP测试套件?

### 面向MCP服务器开发人员

如果您正在构建MCP服务器,MCP测试套件可以帮助您:

- **验证正确性**:确保您的服务器正确实现MCP协议
- **测试工具**:验证您的工具是否返回预期结果
- **测试资源**:确认资源可访问并返回正确的数据
- **测试错误处理**:验证错误响应是否符合MCP标准
- **回归测试**:在bug进入生产环境之前将其捕获
- **文档**:测试是服务器行为的实时文档

### 示例用例

假设你构建了一个气象MCP服务器。使用MCP测试套件,您可以编写以下测试:```typescript
it(&#x27;should return weather data for San Francisco&#x27;, async () =&gt; {
const result = await client.callTool(&#x27;get-weather&#x27;, {
city: &#x27;San Francisco&#x27;
});

expect(result).toMatchMCPToolResponse();
expect(result.content[0].text).toContain(&#x27;temperature&#x27;);
expect(result.content[0].text).toContain(&#x27;San Francisco&#x27;);
});

it(&#x27;should handle invalid city names&#x27;, async () =&gt; {
await expect(
client.callTool(&#x27;get-weather&#x27;, { city: &#x27;&#x27; })
).rejects.toMatchMCPError({
code: -32602,
message: /invalid.*city/i
});
});

📦 安装```bash

Using npm

npm install --save-dev @crashbytes/mcp-test-kit

Using yarn

yarn add -D @crashbytes/mcp-test-kit

Using pnpm

pnpm add -D @crashbytes/mcp-test-kit


### 先决条件

- Node.js 18+
- 测试框架(Vitest推荐)
- TypeScript(可选,但推荐)

## 🚀 快速开始

### 1.创建您的第一个测试```typescript
// tests/weather-server.test.ts
import { describe, it, expect, beforeAll, afterAll } from &#x27;vitest&#x27;;
import { createMCPTestClient } from &#x27;@crashbytes/mcp-test-kit&#x27;;
import type { MCPTestClient } from &#x27;@crashbytes/mcp-test-kit&#x27;;
import &#x27;@crashbytes/mcp-test-kit/matchers&#x27;;

describe(&#x27;Weather MCP Server&#x27;, () =&gt; {
let client: MCPTestClient;

beforeAll(async () =&gt; {
// Connect to your MCP server
client = await createMCPTestClient({
command: &#x27;node&#x27;,
args: [&#x27;dist/server.js&#x27;],
});
});

afterAll(async () =&gt; {
await client.disconnect();
});

it(&#x27;should list available tools&#x27;, async () =&gt; {
const tools = await client.listTools();

expect(tools).toHaveLength(1);
expect(tools[0]).toBeValidMCPTool();
expect(tools[0].name).toBe(&#x27;get-weather&#x27;);
});

it(&#x27;should get weather for a city&#x27;, async () =&gt; {
const result = await client.callTool(&#x27;get-weather&#x27;, {
city: &#x27;London&#x27;,
});

expect(result).toMatchMCPToolResponse();
expect(result.content[0].text).toContain(&#x27;London&#x27;);
});
});

2.运行测试```bash

npm test


就是这样!您现在正在测试MCP服务器。

## 🧩 核心概念

### MCPTestClient

这 `MCPTestClient` 是测试MCP服务器的主界面。它

- 将MCP服务器作为子进程生成
- 使用MCP协议建立连接
- 提供调用工具、列出资源等的方法。
- 测试完成后处理清理

**关键方法:**

- `listTools()`:从服务器获取所有可用工具
- `callTool(name, args)`:使用参数执行工具
- `listResources()`:获取所有可用资源
- `readResource(uri)`:阅读特定资源
- `listPrompts()`:获取所有可用提示
- `getPrompt(name, args)`:获取特定提示

### 定制配对器

MCP测试套件为MCP特定的断言提供自定义Vitest匹配器:

#### `toBeValidMCPTool()`

验证对象是否是格式正确的MCP工具:```typescript
const tool = {
name: &#x27;calculate&#x27;,
description: &#x27;Performs calculations&#x27;,
inputSchema: {
type: &#x27;object&#x27;,
properties: {
expression: { type: &#x27;string&#x27; }
}
}
};

expect(tool).toBeValidMCPTool();

toBeValidMCPResource()

验证对象是否是格式正确的MCP资源:```typescript
const resource = {
uri: 'file:///data/users.json',
name: 'Users Database',
description: 'List of all users'
};

expect(resource).toBeValidMCPResource();


#### `toMatchMCPToolResponse()`

验证工具响应的结构:```typescript
const response = await client.callTool(&#x27;get-weather&#x27;, { city: &#x27;Paris&#x27; });

expect(response).toMatchMCPToolResponse();
expect(response.content[0].text).toContain(&#x27;Paris&#x27;);

toMatchMCPError(error)

验证MCP错误响应:```typescript
await expect(
client.callTool('invalid-tool', {})
).rejects.toMatchMCPError({
code: -32601, // Method not found
message: /not found/i
});


#### `toHaveMCPProtocolVersion(version)`

验证MCP协议版本:```typescript
const info = await client.getServerInfo();
expect(info).toHaveMCPProtocolVersion(&#x27;2024-11-05&#x27;);

📚 API 参考

createMCPTestClient(配置)

创建并连接到MCP测试客户端。

参数:```typescript
interface MCPTestClientConfig {
command: string; // Command to run (e.g., 'node', 'python')
args?: string[]; // Arguments for the command
env?: Record; // Environment variables
timeout?: number; // Timeout in milliseconds (default: 5000)
transport?: 'stdio'; // Transport type (only stdio supported)
debug?: boolean; // Enable debug logging
}


**退货:** `Promise`

**例子:**```typescript
const client = await createMCPTestClient({
command: &#x27;node&#x27;,
args: [&#x27;dist/server.js&#x27;],
env: {
NODE_ENV: &#x27;test&#x27;,
DATABASE_URL: &#x27;sqlite::memory:&#x27;
},
timeout: 10000,
debug: true
});

MCPTestClient方法

listTools(): Promise

列出MCP服务器上可用的所有工具。```typescript
const tools = await client.listTools();
console.log(tools[0].name); // 'get-weather'


#### `callTool(name: string, args?: object): Promise`

使用给定的参数执行工具。```typescript
const result = await client.callTool(&#x27;calculate&#x27;, {
expression: &#x27;2 + 2&#x27;
});

listResources(): Promise

列出MCP服务器上可用的所有资源。```typescript
const resources = await client.listResources();
console.log(resources[0].uri); // 'file:///data/users.json'


#### `readResource(uri: string): Promise`

读取特定资源的内容。```typescript
const content = await client.readResource(&#x27;file:///data/users.json&#x27;);
console.log(content.text);

listPrompts(): Promise

列出MCP服务器上可用的所有提示。```typescript
const prompts = await client.listPrompts();


#### `getPrompt(name: string, args?: Record): Promise`

获取带有参数的特定提示。```typescript
const prompt = await client.getPrompt(&#x27;code-review&#x27;, {
language: &#x27;typescript&#x27;
});

disconnect(): Promise

断开与MCP服务器的连接并清理资源。```typescript
await client.disconnect();


## 💻 例子

### 示例1:测试计算器服务器```typescript
import { describe, it, expect, beforeAll, afterAll } from &#x27;vitest&#x27;;
import { createMCPTestClient, MCPTestClient } from &#x27;@crashbytes/mcp-test-kit&#x27;;
import &#x27;@crashbytes/mcp-test-kit/matchers&#x27;;

describe(&#x27;Calculator MCP Server&#x27;, () =&gt; {
let client: MCPTestClient;

beforeAll(async () =&gt; {
client = await createMCPTestClient({
command: &#x27;node&#x27;,
args: [&#x27;dist/calculator-server.js&#x27;],
});
});

afterAll(async () =&gt; {
await client.disconnect();
});

describe(&#x27;Basic Operations&#x27;, () =&gt; {
it(&#x27;should add two numbers&#x27;, async () =&gt; {
const result = await client.callTool(&#x27;calculate&#x27;, {
operation: &#x27;add&#x27;,
a: 5,
b: 3
});

expect(result).toMatchMCPToolResponse();
expect(result.content[0].text).toBe(&#x27;8&#x27;);
});

it(&#x27;should handle division by zero&#x27;, async () =&gt; {
await expect(
client.callTool(&#x27;calculate&#x27;, {
operation: &#x27;divide&#x27;,
a: 10,
b: 0
})
).rejects.toMatchMCPError({
code: -32602,
message: /division by zero/i
});
});
});

describe(&#x27;Tool Validation&#x27;, () =&gt; {
it(&#x27;should have valid tool schema&#x27;, async () =&gt; {
const tools = await client.listTools();
const calcTool = tools.find(t =&gt; t.name === &#x27;calculate&#x27;);

expect(calcTool).toBeValidMCPTool();
expect(calcTool?.inputSchema.properties).toHaveProperty(&#x27;operation&#x27;);
expect(calcTool?.inputSchema.properties).toHaveProperty(&#x27;a&#x27;);
expect(calcTool?.inputSchema.properties).toHaveProperty(&#x27;b&#x27;);
});
});
});

示例2:测试数据库服务器```typescript

import { describe, it, expect, beforeAll, afterAll } from 'vitest';
import { createMCPTestClient, MCPTestClient } from '@crashbytes/mcp-test-kit';
import '@crashbytes/mcp-test-kit/matchers';

describe('Database MCP Server', () => {
let client: MCPTestClient;

beforeAll(async () => {
client = await createMCPTestClient({
command: 'node',
args: ['dist/db-server.js'],
env: {
DATABASE_URL: 'sqlite::memory:',
NODE_ENV: 'test'
}
});
});

afterAll(async () => {
await client.disconnect();
});

it('should query users from database', async () => {
const result = await client.callTool('query', {
sql: 'SELECT * FROM users WHERE age > 18'
});

expect(result).toMatchMCPToolResponse();
const data = JSON.parse(result.content[0].text);
expect(Array.isArray(data)).toBe(true);
});

it('should list database resources', async () => {
const resources = await client.listResources();

expect(resources.length).toBeGreaterThan(0);
resources.forEach(resource => {
expect(resource).toBeValidMCPResource();
});
});

it('should read table schema', async () => {
const content = await client.readResource('schema://users');

expect(content.text).toContain('id');
expect(content.text).toContain('name');
expect(content.text).toContain('email');
});
});


### 示例3:使用模拟进行测试```typescript
import { describe, it, expect } from &#x27;vitest&#x27;;
import { createMockMCPServer, mockTool } from &#x27;@crashbytes/mcp-test-kit/mocks&#x27;;

describe(&#x27;Mock MCP Server&#x27;, () =&gt; {
it(&#x27;should create a mock server with tools&#x27;, async () =&gt; {
const server = createMockMCPServer({
tools: [
mockTool(
&#x27;greet&#x27;,
async (args) =&gt; ({
content: [{ type: &#x27;text&#x27;, text: `Hello, ${args.name}!` }]
}),
{
description: &#x27;Greets a person&#x27;,
inputSchema: {
type: &#x27;object&#x27;,
properties: {
name: { type: &#x27;string&#x27; }
}
}
}
)
]
});

const tools = server.getTools();
expect(tools).toHaveLength(1);
expect(tools[0].name).toBe(&#x27;greet&#x27;);

const result = await server.callTool(&#x27;greet&#x27;, { name: &#x27;World&#x27; });
expect(result.content[0].text).toBe(&#x27;Hello, World!&#x27;);
});
});

🎓 最佳实践

1.使用before All/after All进行连接管理```typescript

let client: MCPTestClient;

beforeAll(async () => {
client = await createMCPTestClient({ / config / });
});

afterAll(async () => {
await client.disconnect();
});


### 2.测试成功和失败案例```typescript
// Test success
it(&#x27;should return data for valid input&#x27;, async () =&gt; {
const result = await client.callTool(&#x27;tool&#x27;, { valid: true });
expect(result).toMatchMCPToolResponse();
});

// Test failure
it(&#x27;should reject invalid input&#x27;, async () =&gt; {
await expect(
client.callTool(&#x27;tool&#x27;, { invalid: true })
).rejects.toMatchMCPError({ code: -32602 });
});

3.验证工具模式```typescript

it('should have properly defined tools', async () => {
const tools = await client.listTools();

tools.forEach(tool => {
expect(tool).toBeValidMCPTool();
expect(tool.description).toBeTruthy();
expect(tool.inputSchema.properties).toBeDefined();
});
});


### 4.使用描述性测试名称```typescript
// ❌ Bad
it(&#x27;test 1&#x27;, async () =&gt; { /* ... */ });

// ✅ Good
it(&#x27;should return weather data for valid city names&#x27;, async () =&gt; { /* ... */ });

5.隔离测试

每个测试都应该是独立的,不依赖于其他测试的状态。```typescript
// ❌ Bad - Tests depend on order
it('creates a user', async () => { / ... / });
it('updates the user', async () => { / assumes user exists / });

// ✅ Good - Each test is independent
beforeEach(async () => {
await client.callTool('reset-database', {});
});

it('creates a user', async () => { / ... / });
it('updates a user', async () => {
await client.callTool('create-user', { name: 'Test' });
await client.callTool('update-user', { name: 'Updated' });
});


## 🤝 贡献

欢迎投稿!请随时提交拉取请求。

### 开发设置```bash
# Clone the repository
git clone https://github.com/crashbytes/mcp-test-kit.git
cd mcp-test-kit

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

# Run linter
npm run lint

📄 许可证

MIT© 黑洞软件有限责任公司

🔗 链接

  • NPM包: https://www.npmjs.com/package/@crashbytes/mcp测试套件
  • GitHub: https://github.com/crashbytes/mcp-test-kit
  • MCP规范: https://spec.modelcontextprotocol.io/
  • CrashBytes博客: https://crashbytes.com

🙏 致谢

  • Anthropic 用于创建模型上下文协议
  • 维测试 优秀的测试框架
  • MCP社区提供反馈和贡献

建于❤️ 通过 CrashBytes

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Test Kit 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Test Kit 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Test Kit 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Test Kit 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Test Kit 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Test Kit 能提供哪些能力?

资料显示能力标签包括 测试框架、服务器测试、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。