MCP Mesh Test Suite

苏铁矿

YAML驱动的集成测试框架，具有容器隔离和实时监控功能。

安装

npm install -g @mcpmesh/tsuite

快速开始

# View the quickstart guide
tsuite man quickstart

# Start the dashboard (includes API server)
tsuite api --port 9999

# Open http://localhost:9999 in your browser

命令

运行测试

# Run all tests in Docker mode
tsuite run --suite ./my-suite --all --docker

# Run specific use case
tsuite run --suite ./my-suite --uc uc01_registry --docker

# Run specific test case
tsuite run --suite ./my-suite --tc uc01_registry/tc01_agent_registration --docker

# Run tests matching tags
tsuite run --suite ./my-suite --tag smoke --docker

# Dry run (list tests without executing)
tsuite run --suite ./my-suite --dry-run --all

仪表板和API服务器

# Start on default port (9999)
tsuite api

# Start on custom port
tsuite api --port 8080

# Start in background (detached)
tsuite api --detach

# Stop background server
tsuite stop

脚手架测试用例

从代理目录生成测试用例：

# Interactive mode
tsuite scaffold --suite ./my-suite ./path/to/agent1 ./path/to/agent2

# Non-interactive mode
tsuite scaffold --suite ./my-suite --uc uc01_tags --tc tc01_test ./agent1 ./agent2

# Preview without creating files
tsuite scaffold --suite ./my-suite --uc uc01_tags --tc tc01_test --dry-run ./agent1

文档

# List available topics
tsuite man --list

# View specific topic
tsuite man quickstart
tsuite man handlers
tsuite man assertions
tsuite man routines

清除数据

# Clear all test data
tsuite clear --all

# Clear specific run
tsuite clear --run-id 

特性

• 基于YAML的测试定义 -测试作为配置，而不是代码
• 容器隔离 -每个测试都在一个新的Docker容器中运行
• 并行执行 -用于并发测试运行的工作池
• Web仪表板 -实时监控、历史记录和测试编辑器
• 可插拔处理器 -shell、http、文件、等待、pip安装、npm安装
• 表达式语言 -支持jq和JSONPath的灵活断言
• 可重复使用的例程 -定义一次，跨测试使用
• 脚手架指挥 -从代理目录自动生成测试用例

测试套件结构

my-suite/
├── config.yaml              # Suite configuration
├── global/
│   └── routines.yaml        # Global reusable routines
└── suites/
    └── uc01_example/        # Use case folder
        ├── routines.yaml    # UC-level routines (optional)
        └── tc01_test/       # Test case folder
            ├── test.yaml    # Test definition
            └── artifacts/   # Test artifacts (agents, fixtures)

示例测试

name: "Agent Registration Test"
description: "Verify agent registers with mesh"
tags: [smoke, registry]
timeout: 300

pre_run:
  - routine: global.setup_for_python_agent
    params:
      meshctl_version: "${config.packages.cli_version}"

test:
  - name: "Copy agent to workspace"
    handler: shell
    command: "cp -r /artifacts/my-agent /workspace/"

  - name: "Start agent"
    handler: shell
    command: "meshctl start my-agent/main.py -d"
    workdir: /workspace

  - name: "Wait for registration"
    handler: wait
    seconds: 5

  - name: "Verify agent registered"
    handler: shell
    command: "meshctl list"
    capture: agent_list

assertions:
  - expr: "${captured.agent_list} contains 'my-agent'"
    message: "Agent should be registered"

post_run:
  - handler: shell
    command: "meshctl stop || true"
    workdir: /workspace

文档

跑 tsuite man 详细文档：

看 docs/USER_GUIDE.md 以获取全面的文档。

发展

# Build from source
make build

# Build with dashboard embedded
make build-with-dashboard

# Run tests
make test

许可证

麻省理工学院