Sauce Api MCP

🚀 Sauce Labs MCP 服務器

Sauce Labs MCP 服務器是一個模型上下文協議（MCP）服務器，它與 Sauce Labs 測試平臺實現了全面集成。該服務器使 AI 助手（大語言模型客戶端）能夠通過自然語言對話，直接與 Sauce Labs 的設備雲進行交互、管理測試作業、分析構建情況以及監控測試基礎設施。

✨ 主要特性

🚀 核心功能

• 賬戶管理：查看賬戶詳情、團隊信息和用戶權限
• 設備雲訪問：瀏覽 300 多種真實設備（iOS、Android）和虛擬機
• 測試作業管理：檢索近期作業、分析測試結果並調試失敗情況
• 構建監控：跟蹤構建狀態、查看作業集合並分析測試套件
• 存儲管理：管理上傳的應用程序和測試工件
• 隧道監控：檢查 Sauce Connect 隧道狀態和配置

🔧 高級特性

• 即時設備狀態：監控數據中心內設備的可用性和使用情況
• 跨平臺測試：支持虛擬設備雲（VDC）和真實設備雲（RDC）
• 測試分析：提供詳細的作業信息，包括日誌、視頻和性能指標
• 團隊協作：支持多團隊協作，並具備適當的訪問控制

📦 安裝指南

在所有情況下，你都需要將 start_server.sh.template 重命名為 start_server.sh，並將 /path/to/sauce-api-mcp 替換為你環境中的正確絕對路徑。

前提條件

• Python 3.8 及以上版本
• 具有 API 訪問權限的 Sauce Labs 賬戶
• Claude Desktop 應用程序

針對 Claude Desktop（Mac）

1. 安裝 MCP 服務器：

# 克隆倉庫
git clone https://github.com/saucelabs/sauce-api-mcp.git
cd sauce-api-mcp

# 安裝依賴項
pip install -e .

2. 配置 Claude Desktop：

編輯你的 Claude Desktop 配置文件：

~/Library/Application\ Support/Claude/claude_desktop_config.json

3. 添加 Sauce Labs MCP 服務器配置：

{
    "mcpServers": {
        "sauce-labs": {
            "command": "python",
            "args": ["/path/to/sauce-api-mcp/src/main.py"],
            "env": {
                "SAUCE_USERNAME": "your-sauce-username",
                "SAUCE_ACCESS_KEY": "your-sauce-access-key"
            }
        }
    }
}

4. 重啟 Claude Desktop 以加載新的 MCP 服務器。

針對 Claude Desktop（Windows）

1. 安裝 MCP 服務器：

# 克隆倉庫
git clone https://github.com/saucelabs/sauce-api-mcp.git
cd sauce-api-mcp.git

# 安裝依賴項
pip install -e .

2. 配置 Claude Desktop： 編輯你的 Claude Desktop 配置文件：

# 打開配置文件（將 USERNAME 替換為你的 Windows 用戶名）
notepad %APPDATA%\Claude\claude_desktop_config.json

3. 添加 Sauce Labs MCP 服務器配置：

{
    "mcpServers": {
        "sauce-labs": {
            "command": "python",
            "args": ["/path/to/sauce-api-mcp/src/main.py"],
            "env": {
                "SAUCE_USERNAME": "your-sauce-username",
                "SAUCE_ACCESS_KEY": "your-sauce-access-key"
            }
        }
    }
}

4. 重啟 Claude Desktop 以加載新的 MCP 服務器。

針對 Claude Code（終端集成）

Claude Code 允許你直接從終端使用 Sauce Labs MCP 服務器進行 AI 輔助測試工作流。

1. 安裝 Claude Code：

# 安裝 Claude Code（如果尚未安裝）
curl -fsSL https://claude.ai/claude-code/install.sh | sh

2. 安裝 Sauce Labs MCP 服務器：

# 克隆並安裝 MCP 服務器
git clone https://github.com/saucelabs/sauce-api-mcp.git
cd sauce-api-mcp
pip install -e .

3. 配置大語言模型客戶端：

Claude Code

創建或編輯你的 Claude Code 配置：

# 如果配置目錄不存在，則創建它
mkdir -p ~/.config/claude-code

code ~/.config/claude-code/config.json

添加 Sauce Labs MCP 服務器配置：

{
    "mcpServers": {
        "sauce-labs": {
            "command": "sauce-api-mcp.git",
            "env": {
                "SAUCE_USERNAME": "your-sauce-username",
                "SAUCE_ACCESS_KEY": "your-sauce-access-key"
            }
        }
    }
}

Goose

在你的 ~/.config/goose/config.yaml 文件中，添加以下擴展：

sauce-api-mcp:
    args: []
    bundled: null
    cmd: /<path>/sauce-api-mcp/start_server.sh
    description: Sauce Labs MCP for API
    enabled: true
    env_keys: []
    envs: {}
    name: sauce-api-mcp
    timeout: 10
    type: stdio

Gemini CLI

在你的 ~/.gemini/settings.json 文件中，添加以下內容：

{
    "mcpServers": {
        "sauce-api-mcp": {
            "command": "/Users/marcusmerrell/Projects/sauce-api-mcp/start_server.sh",
            "args": []
        }
    }
}

現在你可以提出如下問題：

• "顯示我最近的測試失敗情況"
• "查找可用於測試的 iPhone 設備"
• "分析我最新構建的性能"

📚 詳細文檔

必需的環境變量

• SAUCE_USERNAME：你的 Sauce Labs 用戶名
• SAUCE_ACCESS_KEY：你的 Sauce Labs 訪問密鑰（在賬戶設置中找到）

可選配置

• SAUCE_REGION：Sauce Labs 數據中心區域（默認：us - west - 1）
• SAUCE_API_BASE：自定義 API 基礎 URL（適用於企業賬戶）

獲取你的 Sauce Labs 憑證

1. 登錄你的 Sauce Labs 賬戶
2. 導航到“賬戶”→“用戶設置”
3. 複製你的用戶名和訪問密鑰
4. 將這些添加到你的 Claude Desktop 配置中

💻 使用示例

設備管理

"顯示所有可用的 iPhone 設備"
"當前正在使用哪些 Android 設備？"
"為我找到一臺用於測試的三星 Galaxy S24"

測試作業分析

"顯示我最近的測試作業"
"分析我上次構建中的失敗測試"
"獲取作業 ID 為 abc123def456 的詳細信息"

構建監控

"我最新構建的狀態如何？"
"顯示本週的所有構建"
"查找有失敗測試的構建"

存儲管理

"列出我上傳的應用程序"
"顯示應用程序存儲使用情況"
"查找 iOS 演示應用程序"

團隊協作

"我的測試團隊有哪些成員？"
"顯示團隊設備分配情況"
"列出我組織中的所有用戶"

🔧 技術細節

可用工具

賬戶與組織

• get_account_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_builds - 使用各種過濾器搜索構建
• get_build - 獲取特定構建的詳細信息
• lookup_jobs_in_build - 列出特定構建中的所有作業

存儲

• get_storage_files - 列出上傳的應用程序文件
• get_storage_groups - 列出應用程序存儲組
• get_storage_groups_settings - 獲取特定存儲組的設置

隧道

• get_tunnels_for_user - 列出活動的 Sauce Connect 隧道
• get_tunnel_information - 獲取特定隧道的詳細信息
• get_current_jobs_for_tunnel - 查看使用特定隧道的作業

測試資產

• get_test_assets - 檢索測試工件（日誌、視頻、截圖）
• get_log_json_file - 獲取結構化的測試執行日誌

📄 許可證

本項目採用 MIT 許可證 - 有關詳細信息，請參閱 LICENSE 文件。

常見問題排查

常見問題

"未找到 MCP 服務器"

• 確保 MCP 服務器可執行文件的路徑正確
• 驗證 Python 已安裝且可訪問
• 檢查所有依賴項是否已安裝

"身份驗證失敗"

• 驗證你的 SAUCE_USERNAME 和 SAUCE_ACCESS_KEY 是否正確
• 確保憑證對請求的操作具有適當的權限
• 檢查你的 Sauce Labs 賬戶是否處於活動狀態

"未找到設備"

• 驗證你的賬戶是否有權訪問設備雲
• 檢查你所在團隊的設備分配設置
• 確保你查詢的是正確的數據中心區域

"未找到作業"

• 驗證作業 ID 是否正確且屬於你的賬戶
• 檢查作業是來自 VDC 還是 RDC（不同的端點）
• 確保作業未因保留策略而過期

調試模式

通過設置環境變量啟用調試日誌記錄：

{
    "env": {
        "SAUCE_USERNAME": "your-username",
        "SAUCE_ACCESS_KEY": "your-access-key"
    }
}

獲取幫助

• Sauce Labs 文檔：docs.saucelabs.com
• API 參考：docs.saucelabs.com/dev/api
• 支持：通過你的賬戶儀表盤聯繫 Sauce Labs 支持團隊

項目路線圖

本路線圖概述了我們對該項目的願景和優先級。它是一份動態文檔，我們歡迎社區提供反饋和貢獻！雖然我們旨在遵循此計劃，但優先級可能會根據用戶反饋和新機會而變化。

如果你想提供幫助，我們非常歡迎！

• 查看我們的 CONTRIBUTING.md 指南。
• 在我們的 問題跟蹤器 中找到你感興趣的現有問題。
• 有新想法？打開一個新問題 與我們討論。

🎯 短期（未來 1 - 3 個月）

我們的近期重點是增強核心開發者體驗並改進上下文管理。

資源與工具 - 優化模型調用

• 描述：為模型響應全面實現資源功能。對於某些提示，這將通過返回緩存結果而不是進行新的 API 調用，從而減少延遲和成本。
• 狀態：規劃中

🚀 中期（3 - 6 個月）

我們計劃專注於添加 API 端點並改進與大語言模型的整體交互。我們還將維護服務器以跟上 Sauce Labs API 的變化，並在引入新產品線時添加支持。

免責聲明

擔保免責聲明

本軟件“按原樣”提供，不提供任何形式的明示或暗示擔保，包括但不限於適銷性、特定用途適用性和不侵權的擔保。在任何情況下，作者或版權持有者均不對因合同、侵權或其他方式引起的任何索賠、損害或其他責任負責，無論該責任是由本軟件的使用或其他交易引起的。

責任限制

在任何情況下，Sauce Labs, Inc. 均不對任何直接、間接、偶然、特殊、懲戒性或後果性損害（包括但不限於替代商品或服務的採購；使用、數據或利潤的損失；或業務中斷）負責，無論該損害是如何引起的，也無論責任理論是基於合同、嚴格責任還是侵權（包括疏忽或其他方式），即使已被告知此類損害的可能性。

一般使用

MCP 服務器作為一個免費的開源工具提供，以促進與公開可用 API 的交互。用戶可以根據 MIT 許可證的條款自由修改和分發該軟件。

通過使用本軟件，你承認你是自行承擔風險使用的，並且你有責任遵守所有適用的法律法規。

賠償責任

你同意賠償並使 Sauce Labs, inc.（“Sauce Labs”）及其管理人員、董事、員工和代理人免受因你訪問或使用本軟件而引起的任何和所有索賠、責任、損害、損失或費用（包括合理的律師費和成本）。

這包括但不限於：

• 你與第三方大語言模型提供商的交互：你承認本軟件使用公開可用的 API 與大語言模型（LLM）進行交互。你獨自負責使用任何第三方大語言模型服務。這包括你遵守大語言模型提供商的條款和條件以及與你的使用相關的任何成本，如令牌費用。Sauce Labs 對任何第三方大語言模型提供商的內容、隱私政策或做法沒有控制權，也不承擔任何責任。
• 大語言模型生成的內容：你獨自負責通過使用 MCP 服務器和底層大語言模型生成、接收或傳輸的內容。Sauce Labs 不認可也無法控制你或任何第三方通過服務器進行的通信內容。
• 你的代碼和修改：你基於 MCP 服務器創建的任何修改、增強或衍生作品均屬於你自己，你獨自對其性能和使用可能產生的任何責任負責。