Sauce Labs MCP Server

Sauce Labs MCP服务器

一个模型上下文协议（MCP）服务器，提供与Sauce Labs测试平台的全面集成。该软件包包括两个互补的MCP服务器，使AI助手（LLM客户端）能够直接通过自然语言对话与Sauce Labs的设备云交互、管理测试作业、分析构建和监控测试基础设施。

服务器

此软件包提供了两个针对不同用例优化的独立MCP服务器：

酱汁原料药 （核心服务器）-全面的Sauce Labs API集成，用于帐户管理、设备发现、作业分析、构建、存储和隧道。

酱汁原料药mcp rdc （RDC OpenAPI服务器）-专注于真实设备云（RDC）的服务器，具有自动OpenAPI模式发现功能，并针对移动设备测试工作流程进行了优化。

两台服务器都可以在LLM客户端中同时配置，以实现全面的Sauce Labs集成。

特性

🚀 核心能力

• 账户管理：查看帐户详细信息、团队信息和用户权限
• 设备云访问：浏览300多台真实设备（iOS、Android）和虚拟机
• 测试作业管理：检索最近的作业、分析测试结果和调试失败
• 构建监控：跟踪构建状态、查看作业集合和分析测试套件
• 存储管理：管理上传的应用程序和测试工件
• 隧道监测：检查Sauce Connect隧道状态和配置

🔧 高级功能

• 实时设备状态：监控整个数据中心的设备可用性和使用情况
• 跨平台测试：支持虚拟设备云（VDC）和真实设备云（RDC）
• 测试分析：详细的作业信息，包括日志、视频和绩效指标
• 团队协作：具有适当访问控制的多团队支持
• RDC OpenAPI集成：针对真实设备云端点的动态API发现（stud-API-mcp-rdc）

先决条件

• Python 3.10+
• pip
• 拥有API访问权限的Sauce Labs帐户
• Gemini CLI、Claude Desktop、Goose或其他LLM客户端

适用于Claude Desktop（Mac/Linux）或Gemini CLI

从PyPI安装软件包：

pip install sauce-api-mcp

这将安装两台服务器并使其命令行入口点可用：

• sauce-api-mcp （核心服务器）
• sauce-api-mcp-rdc （RDC OpenAPI服务器）

验证安装：

which sauce-api-mcp
which sauce-api-mcp-rdc

LLM客户端的配置

克劳德桌面（Mac/Linux/Windows）

1. 找到您的Claude Desktop配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 查找Python安装的bin目录：

   python3 -c "import sys; print(sys.prefix + '/bin')"

在macOS和Python系统上，这通常是：

   /Library/Frameworks/Python.framework/Versions/3.12/bin

1. 使用步骤2中的完整路径将两台服务器添加到配置中：

   {
     "mcpServers": {
       "sauce-api-mcp-core": {
         "command": "/path/to/bin/sauce-api-mcp",
         "env": {
           "SAUCE_USERNAME": "your-sauce-username",
           "SAUCE_ACCESS_KEY": "your-sauce-access-key"
         }
       },
       "sauce-api-mcp-rdc": {
         "command": "/path/to/bin/sauce-api-mcp-rdc",
         "env": {
           "SAUCE_USERNAME": "your-sauce-username",
           "SAUCE_ACCESS_KEY": "your-sauce-access-key"
         }
       }
     }
   }

1. 重新启动客户端以加载服务器。

双子星命令行工具

增添 ~/.gemini/settings.json:

{
  "mcpServers": {
    "sauce-api-mcp-core": {
      "command": "/path/to/bin/sauce-api-mcp",
      "env": {
        "SAUCE_USERNAME": "your-sauce-username",
        "SAUCE_ACCESS_KEY": "your-sauce-access-key"
      }
    }
  }
}

鹅

增添 ~/.config/goose/config.yaml:

sauce-api-mcp-core:
  cmd: /path/to/bin/sauce-api-mcp
  description: Sauce Labs MCP (Core)
  enabled: true
  envs:
    SAUCE_USERNAME: your-sauce-username
    SAUCE_ACCESS_KEY: your-sauce-access-key
  type: stdio

sauce-api-mcp-rdc:
  cmd: /path/to/bin/sauce-api-mcp-rdc
  description: Sauce Labs MCP (RDC)
  enabled: true
  envs:
    SAUCE_USERNAME: your-sauce-username
    SAUCE_ACCESS_KEY: your-sauce-access-key
  type: stdio

环境变量（备选）

您可以将它们设置为环境变量，而不是将凭据添加到配置文件中：

export SAUCE_USERNAME="your-sauce-username"
export SAUCE_ACCESS_KEY="your-sauce-access-key"

然后省略 env 从您的配置中屏蔽。两台服务器都将自动使用这些环境变量。

安装故障排除

“找不到命令：酱汁api mcp”

入口点脚本不在您的PATH中。验证安装并使用上述完整路径方法：

python3 -m pip list | grep sauce-api-mcp
python3 -c "import sys; print(sys.prefix + '/bin/sauce-api-mcp')"

MCP客户端中没有这样的文件或目录

MCP客户端使用的Python环境与安装包的环境不同。解决：

1. 使用完整绝对路径 （推荐）：更新配置以使用以下所示的完整路径 python3 -c "import sys; print(sys.prefix + '/bin/sauce-api-mcp')"，不仅 which sauce-api-mcp

1. 在系统中安装Python：如果您使用的是特定的Python安装，请确保 pip install 使用相同的Python

1. 替代方案：模块调用 （可靠性较低）：

   "command": "python3",
   "args": ["-m", "sauce_api_mcp.main"]

开发设置

先决条件

• Python 3.10+
• uv 包管理器(安装uv)
• Git

克隆和设置

git clone https://github.com/saucelabs/sauce-api-mcp.git
cd sauce-api-mcp
uv sync

这将创建一个虚拟环境，并在可编辑模式下安装所有依赖项。

项目结构

sauce-api-mcp/
├── src/sauce_api_mcp/
│   ├── __init__.py
│   ├── main.py              # Core server entry point
│   ├── rdc_openapi.py       # RDC OpenAPI server entry point
│   └── shared/              # Shared utilities
├── pyproject.toml           # Package configuration & entry points
├── uv.lock                  # Locked dependencies
└── README.md

入口点

这 pyproject.toml 定义了两个控制台脚本：

[project.scripts]
sauce-api-mcp = "sauce_api_mcp.main:main"
sauce-api-mcp-rdc = "sauce_api_mcp.rdc_openapi:main"

当你奔跑时 uv sync，这些命令在虚拟环境中可用。

开发流程

1. 激活虚拟环境 （可选， uv 命令在没有它的情况下工作）：

   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

1. 在本地运行服务器 （用于测试）：

   uv run sauce-api-mcp
   uv run sauce-api-mcp-rdc

两者都将输出： Error: This server is not meant to be run interactively --这是正确的行为（它们应该由MCP客户端调用）。

1. 使用环境变量运行:

   SAUCE_USERNAME=user SAUCE_ACCESS_KEY=key uv run sauce-api-mcp

1. 使用您的MCP客户端进行测试:

   {
     "command": "/path/to/sauce-api-mcp/.venv/bin/sauce-api-mcp"
   }

运行测试

uv run pytest
uv run pytest -v  # Verbose
uv run pytest src/sauce_api_mcp/tests/test_main.py  # Specific test

添加依赖关系

uv add httpx
uv add --dev pytest-asyncio

现在你可以问这样的问题：

• “显示我最近的测试失败”
• “查找可用的iPhone设备进行测试”
• “分析我最新版本的性能”

配置

所需的环境变量

• 碟子_用户名：您的酱汁实验室用户名
• 飞碟_通行证_钥匙：您的Sauce Labs访问密钥（在帐户设置中找到）

可选配置

• 飞碟区域：Sauce Labs数据中心区域（默认：us-west-1）

获取Sauce Labs证书

1. 登录您的Sauce Labs帐户
2. 导航到帐户→ 用户设置
3. 复制您的用户名和访问密钥
4. 将这些添加到您的Claude Desktop配置中（或设置为环境变量）

可用工具

账户和组织

• get_count_info -检索当前用户帐户信息
• lookup_users -查找组织中的用户
• get_user -获取详细的用户信息
• lookup_teams -查找组织中的团队
• get_team -获取团队详细信息和成员信息
• list_team_members -列出特定团队的所有成员

设备管理

• get_devices_status -列出所有可用设备及其状态
• get_specific_device -获取特定设备的详细信息
• get_private_devices -列出您帐户可用的私人设备

测试作业

• get_recent_jobs -检索您最近的测试作业
• get_job_details -获取特定工作的全面详细信息
• get_real-device_jobs -列出真实设备上的活动作业
• get_specific_real_device_job -获取特定真实设备作业的详细信息
• get_specific_real_device_job_asset -下载作业资产（日志、视频、截图）

构建

• lookup_建筑物 -搜索具有各种过滤器的版本
• get_build -获取特定版本的详细信息
• lookup_jobs_in_build -列出特定构建中的所有作业

存储

• get_storage_files -列出上传的应用程序文件
• get_storage_groups -列出应用存储组
• get_storage_groups_setting -获取特定存储组的设置

隧道

• get_tunnels_for_user -列出活跃的Sauce Connect隧道
• 获取隧道信息 -获取特定隧道的详细信息
• get_current jobs_for_tunnel -查看使用特定隧道的作业

测试资产

• get_test_assets -检索测试工件（日志、视频、屏幕截图）
• get_log.json文件 -获取结构化测试执行日志

贡献

我们欢迎捐款！看 贡献.md 作为指导方针。

故障排除

“找不到MCP服务器”

确保配置文件中指向MCP服务器可执行文件的路径正确。对于完整路径，请运行：

python3 -c "import sys; print(sys.prefix + '/bin')"

验证Python是否已安装且可访问。检查是否安装了所有依赖项：

python3 -m pip list | grep sauce-api-mcp

“身份验证失败”

验证您的SAUCE_USERNAME和SAUCE_ACCESS_KEY是否正确。确保凭据对请求的操作具有适当的权限。检查您的Sauce Labs帐户是否处于活动状态。

“未找到设备”

验证您的帐户是否可以访问设备云。检查团队的设备分配设置。确保您正在查询正确的数据中心区域（如果需要，请设置SAUCE_region）。

“找不到作业”

验证作业ID是否正确，是否属于您的帐户。检查作业是否来自VDC与RDC（不同端点）。确保作业未因保留策略而过期。

获取帮助

• 酱汁实验室文档： docs.sauclebas.com
• API参考： docs.sauclebas.com/dev/api
• 支持：通过您的帐户控制面板联系Sauce Labs支持
• GitHub问题： 报告错误或请求功能

许可证

Apache 2.0（1.1.0+版本）

注意：1.0.3之前的版本是在MIT许可证下发布的。

路线图

该路线图概述了我们对该项目的愿景和优先事项。这是一份动态文件，我们欢迎社区的反馈和贡献！虽然我们的目标是遵循这一计划，但优先级可以根据用户反馈和新机会而改变。

短期（未来1-3个月）

资源和工具-优化模型调用

• 全面实施模型响应资源
• 通过返回缓存结果而不是新的API调用来减少延迟和成本
• 自动转换linux时间戳以降低错误LLM转换的风险
• 状态：规划

中期（3-6个月）

• 随着Sauce Labs平台的发展，添加新的API端点
• 改善与LLM客户的整体互动
• 与Sauce Labs API更新保持一致
• 添加对Sauce Labs新产品线的支持

更新日志

v1.1.0版本

• 将酱汁api mcp和酱汁实验室mcp（RDC OpenAPI）合并到单个monorepo包中
• 为以rdc为中心的服务器添加了sauce api mcp-rdc入口点
• 更新为使用完整的Python入口点，而不是启动器脚本
• 改进了安装和配置文档
• 使用uv.lock锁定依赖关系，以实现可重复安装

v1.0.3

• 已更新为使用Apache许可证2.0（以前为MIT）
• README的小改进

v1.0.2

• 提交至MCP官方登记处
• 添加了对Python 3.9的支持

v1.0.1

• 对README进行了全面检查和更新，并提供了更好的安装说明

v1.0.0

• 首次发布，与Sauce Labs API完全集成
• 支持VDC和RDC平台
• 全面的设备管理
• 高级作业分析和构建监控
• 跨平台Claude桌面支持

由以下材料制成❤️ 对于测试社区

免责声明

本软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生或与之相关的任何索赔、损害赔偿或其他责任承担责任，无论是在合同、侵权或其他诉讼中。

责任限制

在任何情况下，SAUCE LABS，INC.均不对因使用本软件而以任何方式产生的任何直接、间接、附带、特殊、惩戒性或后果性损害（包括但不限于采购替代商品或服务；使用、数据或利润损失；或业务中断）承担责任，无论是基于何种责任理论，无论是合同、严格责任还是侵权（包括疏忽或其他），即使被告知此类损害的可能性。

通用

MCP服务器是一个免费的开源工具，用于促进与公开可用API的交互。用户可以根据Apache许可证2.0的条款自由修改和分发软件。

通过使用此软件，您承认您将自行承担风险，并对自己遵守所有适用的法律法规负责。

赔偿

您同意赔偿并使Sauce Labs，股份有限公司（“Sauce Labs.”）、其高级职员、董事、员工和代理人免受因您访问或使用本软件而产生的或以任何方式与之相关的任何和所有索赔、责任、损害、损失或费用，包括合理的律师费和成本。

这包括但不限于：

• 您与第三方法学硕士提供者的互动： 您承认该软件利用公开可用的API与大型语言模型（LLM）进行交互。您对使用任何第三方LLM服务负全部责任，包括您遵守LLM提供商的条款和条件以及与您的使用相关的任何费用，如代币费。Sauce Labs对任何第三方LLM提供商的内容、隐私政策或做法没有控制权，也不承担任何责任。

• LLM生成的内容： 您对通过使用MCP服务器和底层LLM生成、接收或传输的内容负全部责任。Sauce Labs不认可也无法控制您或任何第三方通过服务器进行的通信内容。

• 您的代码和修改： 您基于MCP服务器创建的任何修改、增强或衍生作品都是您自己的，您对其性能和使用可能产生的任何责任负全部责任。