MCP 测试库

一个用于运行模型上下文协议 (MCP) 测试的 CLI 工具。

特性

• 用于运行 MCP 测试的 CLI 工具
• 支持运行单个测试文件或测试模式
• 可配置的测试超时和排除模式
• 详细模式，用于输出详细信息
• 使用 TypeScript 编写，具有完整的类型支持
• 兼容模型上下文协议 SDK
• 彩色测试输出，提高可读性
• 全面的测试覆盖率

安装

要作为开发依赖项安装在您的项目中：

npm install --save-dev mcp-testing-library

用法

命令行选项

用法: mcpt [选项] [测试文件...]

选项:
  -v, --version             输出版本号
  -e, --exclude <patterns>  排除匹配该模式的文件（逗号分隔）
                           (默认: "**/node_modules/**,**/dist/**")
  -t, --timeout <ms>        设置测试超时时间，以毫秒为单位 (默认: "30000")
  --pattern <glob>          要匹配的测试文件模式 (默认: "**/*.test.{js,ts}")
  --no-color                禁用彩色输出
  -h, --help                显示命令帮助

示例

运行项目中的所有测试：

mcpt

运行特定的测试文件：

mcpt sample/index.test.ts

使用更长的超时时间运行测试：

mcpt --timeout 10000

运行没有颜色输出的测试：

mcpt --no-color

排除特定的目录：

mcpt --exclude "**/node_modules/**,**/dist/**,**/build/**"

在代码中使用

您也可以直接在代码中使用 MCP 测试实用程序：

import { mcpt, expect } from 'mcp-testing-library';

// 测试文件系统 MCP 服务器
mcpt(
  {
    command: 'npx',
    args: ['-y', '@modelcontextprotocol/server-filesystem', '/path/to/directory'],
  },
  async ({ tools, prompts, resources, isMethodExist }) => {
    expect(tools.length).to.be.greaterThan(0);
    expect(await isMethodExist('list-tools')).to.eq(true);

    // 更多断言...
  }
);

许可证

MIT