Testmo MCP Server

Testmo MCP服务器

特性

• 📋 测试用例管理 -创建、读取、更新和删除测试用例
• 📁 文件夹组织 -创建和管理文件夹以组织测试用例
• 🔍 项目发现 -列出项目、模板和里程碑
• ✅ 逐步测试 -创建包含步骤和预期结果的详细测试用例
• 🏃 试运行支持 -列出并管理试运行
• 🔧 调试工具 -内置API调试功能

先决条件

• Python 3.10+
• A. 睾丸主义 具有API访问权限的帐户
• 来自Testmo实例的API令牌

安装

1.克隆存储库

git clone https://github.com/filipljoljic/Testmo-MCP.git
cd Testmo-MCP

2.创建虚拟环境

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3.安装依赖项

pip install -r requirements.txt

4.配置环境变量

将Testmo凭据设置为环境变量：

export TESTMO_BASE_URL="https://your-instance.testmo.net"
export TESTMO_TOKEN="your_api_token_here"

获取API令牌：

1. 登录您的Testmo实例
2. 首选 设置 → API
3. 生成新的API令牌
4. 复制令牌并在环境变量中使用它

用法

运行MCP服务器

python3 testmoMCP.py

服务器将启动并准备接受来自兼容AI助手的MCP连接。

与Claude Desktop集成

将以下内容添加到您的Claude Desktop配置中(claude_desktop_config.json):

{
  "mcpServers": {
    "testmo": {
      "command": "python3",
      "args": ["/path/to/Testmo-MCP/testmoMCP.py"],
      "env": {
        "TESTMO_BASE_URL": "https://your-instance.testmo.net",
        "TESTMO_TOKEN": "your_api_token_here"
      }
    }
  }
}

与Cursor集成

添加到光标MCP设置中：

{
  "mcpServers": {
    "testmo": {
      "command": "python3",
      "args": ["/path/to/Testmo-MCP/testmoMCP.py"],
      "env": {
        "TESTMO_BASE_URL": "https://your-instance.testmo.net",
        "TESTMO_TOKEN": "your_api_token_here"
      }
    }
  }
}

可用工具

项目管理

测试用例操作

文件夹管理

试运行操作

调试

例子

用步骤创建测试用例

使用自然语言和AI助手：

创建一个名为“用户登录流”的测试用例，其中包含导航登录、输入凭据和验证成功登录的步骤

助理将使用 create_test_case 工具包括：

project_id: 1
title: "User Login Flow"
description: "Verify user can successfully log in to the application"
steps: "1. Navigate to login page | Expected: Login page loads
2. Enter valid credentials | Expected: Fields accept input
3. Click Login button | Expected: User is logged in and redirected to dashboard"

项目列表

“显示所有可用的Testmo项目”

助理会打电话来 list_projects 并返回：

Found Projects:
ID: 1 | Name: Web Application | Active: True
ID: 2 | Name: Mobile App | Active: True

创建有组织的测试用例

在项目1中创建一个名为“身份验证”的文件夹，然后在其中创建一个测试用例

# First creates folder
create_folder(project_id=1, name="Authentication")
# Then creates test case in that folder
create_test_case(project_id=1, folder_id=, title="Login Test", ...)

api参考

此MCP服务器与 Testmo REST API v1.使用的关键端点：

• GET /api/v1/projects -列出项目
• POST /api/v1/projects/{id}/cases -创建测试用例
• GET /api/v1/projects/{id}/cases -列出测试用例
• PATCH /api/v1/projects/{id}/cases -更新测试用例
• DELETE /api/v1/projects/{id}/cases -删除测试用例
• GET /api/v1/projects/{id}/folders -列出文件夹
• POST /api/v1/projects/{id}/folders -创建文件夹

优先级值

创建测试用例时，使用以下优先级ID：

时间估计

估计值在 分钟:

故障排除

API连接问题

1. 验证您的 TESTMO_BASE_URL 是正确的（应该像 https://your-instance.testmo.net)
2. 请检查您的API令牌是否有效并具有适当的权限
3. 使用 debug_api_test 诊断连接问题的工具

测试用例创建失败

1. 确保您使用的是有效的 project_id （使用 list_projects 第一）
2. 对于基于步骤的测试用例，请获取正确的 template_id 使用 get_project_templates
3. 如果指定，请验证文件夹是否存在 folder_id

步骤未显示

确保：

1. 使用“案例（步骤）”模板-通过以下方式获取其ID get_project_templates
2. 正确设置步骤格式： "1. Step description | Expected: expected result"

贡献

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

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢

• 睾丸主义 提供一个优秀的测试管理平台
• FastMCP 用于MCP服务器框架
• Anthropic 用于模型上下文协议规范