OpenTester

MCP-First 测试执行基础设施

OpenTester 是专为 AI 编码工具（Claude Code、Cursor、OpenCode 等）设计的测试执行引擎。它提供统一的 DSL 格式和 MCP 接口，让 Agent 能够生成、执行和管理测试用例，实现"编码-测试-修复"的自动化闭环。

核心定位

┌─────────────────────────────────────────┐
│  AI Agent (Claude Code / Cursor / ...)  │
│  ├─ 生成 DSL 测试用例                    │
│  ├─ 决策测试策略                         │
│  └─ 分析失败原因                         │
├─────────────────────────────────────────┤
│  OpenTester (MCP Server)                │
│  ├─ 验证 DSL 语法                        │
│  ├─ 执行测试 (CLI/GUI/TUI)               │
│  ├─ 存储用例/项目                        │
│  └─ 返回结构化结果                       │
├─────────────────────────────────────────┤
│  Web UI (辅助观察面板)                    │
│  ├─ 查看执行进度                         │
│  ├─ 调试用例（创建/编辑）                 │
│  └─ 查看历史报告                         │
└─────────────────────────────────────────┘

安装

pip install opentester

快速开始

启动服务

# 一键启动 FastAPI + MCP（前台模式）
opentester start

# 后台运行
opentester start --daemon

# 只启动 API
opentester start --api

# 只启动 MCP
opentester start --mcp

# 查看状态
opentester status

# 停止服务
opentester stop

# 环境检查
opentester doctor

配置 Claude Code

在 .claude/settings.json 中添加 MCP 配置：

{
  "mcpServers": {
    "opentester": {
      "url": "http://localhost:8001/mcp"
    }
  }
}

核心功能

• DSL 验证: YAML 格式的测试定义语言验证
• 测试执行: 当前实现 CLI、WEB（GUI/TUI 为实验性阶段能力）
• 项目管理: 项目存储于 XDG 数据目录（Windows 为 %LOCALAPPDATA%\\opentester\\）
• 实时监控: WebSocket 实时推送执行进度

MCP 工具列表

端口

• FastAPI: http://localhost:8000
• MCP Server: http://localhost:8001/mcp
• API Docs: http://localhost:8000/docs

数据存储

• 项目数据: ~/.opentester/projects/{project_id}.json
• 执行日志: ~/.opentester/executions/
• PID 文件: ~/.opentester/pids/

开源协议

MIT License