Tox 测试 MCP 服务器

一个 MCP 服务器，它执行 tox 命令来运行项目中使用 pytest 的 Python 测试。该服务器提供了一种通过模型上下文协议 (MCP) 运行和管理 Python 测试的便捷方式。

特性

工具

• run_tox_tests - 使用各种模式和选项执行 tox 测试
  • 支持不同的执行模式：
    • all: 运行所有测试或来自特定组的测试
    • file: 运行来自特定文件的测试
    • case: 运行特定的测试用例
    • directory: 运行指定目录中的所有测试
  • 支持的测试组：
    • clients: 客户端相关测试
    • api: API 端点测试
    • auth: 身份验证测试
    • uploads: 上传功能测试
    • routes: 路由处理程序测试

开发

安装依赖项：

npm install

构建服务器：

npm run build

用于自动重建的开发：

npm run watch

安装

要与 VSCode 一起使用，请将服务器配置添加到您的 MCP 设置文件中，位于： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "tox-testing": {
      "command": "node",
      "args": ["/path/to/tox-testing/build/index.js"],
      "env": {
        "TOX_APP_DIR": "/path/to/your/python/project",
        "TOX_TIMEOUT": "600"
      }
    }
  }
}

配置选项

• env.TOX_TIMEOUT: (可选) 等待测试执行完成的最长时间（以秒为单位）。如果测试运行时间超过此超时，它将被终止。默认为 600 秒（10 分钟）
• env.TOX_APP_DIR: (必需) 包含 tox.ini 文件的目录。这是将执行 tox 命令的位置。该路径应指向 tox.ini 所在的 Python 项目的根目录。

超时对于以下情况尤其重要：

• 防止挂起的测试进程
• 管理长时间运行的集成测试
• 确保 CI/CD 管道不会卡住

用法

该服务器提供了一个名为 run_tox_tests 的工具，可以在不同的模式下使用：

工具参数

// 运行所有测试
{
  "mode": "all"
}

// 运行来自特定组的测试
{
  "mode": "all",
  "group": "api"
}

// 运行来自特定文件的测试
{
  "mode": "file",
  "testFile": "tests/test_api.py"
}

// 运行特定的测试用例
{
  "mode": "case",
  "testFile": "tests/test_api.py",
  "testCase": "test_endpoint_response"
}

// 运行来自特定目录的测试
{
  "mode": "directory",
  "directory": "tests/api/"
}

与 Cline 一起使用

将此 MCP 与 Cline 一起使用时，您可以配置 Cline 的自定义指令以有效地处理测试执行。这是一个推荐的工作流程：

如果被要求对项目运行测试，请使用 tox-testing MCP。请按照以下步骤操作：
1. 运行整个项目中的所有测试，除非您收到运行特定测试文件或测试用例的指示。
2. 审查并重新运行每个失败的测试用例，因为您可以从其输出中排除故障并解决问题。
3. 重复步骤 2，直到测试用例通过。
4. 一旦步骤 1 中的所有失败测试用例都通过，请再次重新运行所有测试并重复所有步骤，直到所有测试都通过。

此工作流程确保：

• 通过首先运行所有测试来实现全面的测试覆盖率
• 通过隔离失败的测试用例来实现有针对性的调试
• 通过重新测试单个案例来验证修复
• 通过再次运行所有测试来进行最终验证

与 Cline 的交互示例：

你：运行此项目的测试
Cline：我将使用 tox-testing MCP 运行所有测试：
{
  "mode": "all"
}

你：修复 test_api.py 中失败的测试
Cline：我将首先运行特定的测试文件：
{
  "mode": "file",
  "testFile": "tests/test_api.py"
}
然后单独处理每个失败的测试用例：
{
  "mode": "case",
  "testFile": "tests/test_api.py",
  "testCase": "test_endpoint_response"
}

贡献

有关我们的行为准则以及提交拉取请求的流程的详细信息，请参阅 CONTRIBUTING.md。