Blacksmith MCP

🚀 Blacksmith MCP

Blacksmith MCP 是一個 MCP 服務器，它能將 Claude 與你的 Blacksmith CI 數據相連接。通過自然對話，你可以查詢工作流運行情況、分析測試失敗原因、檢測不穩定測試以及監控使用情況。

🚀 快速開始

如果你已在 Chrome 中登錄 Blacksmith，則無需進行配置：

# 添加到 Claude Code
claude mcp add blacksmith -- npx blacksmith-mcp

# 設置你的組織（僅需運行一次）
export BLACKSMITH_ORG="your-org-name"

MCP 會自動從 Chrome cookies 中提取你的會話信息，無需手動複製令牌。

✨ 主要特性

• 藉助自然對話，可輕鬆查詢工作流運行、分析測試失敗、檢測不穩定測試以及監控使用情況。
• 能自動從 Chrome cookies 中提取會話信息，避免手動複製令牌。

📦 安裝指南

選項 1：Claude Code CLI

claude mcp add blacksmith -- npx blacksmith-mcp

選項 2：項目配置

在 .mcp.json 中添加以下內容：

{
  "mcpServers": {
    "blacksmith": {
      "type": "stdio",
      "command": "npx",
      "args": ["blacksmith-mcp"],
      "env": {
        "BLACKSMITH_ORG": "your-org-name"
      }
    }
  }
}

選項 3：全局安裝

npm install -g blacksmith-mcp

💻 使用示例

基礎用法

以下是一些與 Claude 進行對話以獲取信息的示例：

調試失敗的運行

> **你:** 為什麼上次 CI 運行失敗了？
>
> **Claude:** *使用 `list_runs(status="failure", limit=1)` 然後使用 `get_failed_tests`*
>
> 上次運行失敗，有 34 個測試失敗。主要問題如下：
> - **連接超時**（12 個測試） - `api/` 中的測試在連接測試數據庫時超時
> - **未定義屬性**（8 個測試） - 在新的暗模式代碼中，`user.settings.theme` 未定義
> - **斷言失敗**（14 個測試） - UI 組件中的快照不匹配

查找不穩定測試

> **你:** 哪些測試不穩定？
>
> **Claude:** *使用 `get_flaky_tests(days=7, min_runs=5)`*
>
> 找到 3 個不穩定測試：
> | 測試 | 不穩定率 | 模式 |
> |------|------------|---------|
> | `should handle concurrent requests` | 40%（4/10 次運行） | 在 CI 上失敗，在本地通過 |
> | `renders loading state` | 20%（2/10 次運行） | 與 setTimeout 存在競態條件 |
> | `validates auth token` | 30%（3/10 次運行） | 間歇性網絡超時 |

比較分支

> **你:** 我的 PR 是否引入了新的測試失敗？
>
> **Claude:** *使用 `compare_test_runs` 比較 PR 運行與基礎分支*
>
> 你的 PR 引入了 2 個新的失敗：
> - `UserProfile.test.tsx`："Cannot read property 'avatar' of undefined"
> - `api/users.test.ts`：預期狀態碼 200，實際得到 404
>
> 5 個之前失敗的測試現在通過了（不錯！）。

📚 詳細文檔

配置

身份驗證

自動（推薦）：在 Chrome 中登錄 app.blacksmith.sh。MCP 會自動提取你的會話 cookie。

手動：設置 BLACKSMITH_SESSION_COOKIE 環境變量，並將其值設置為你的會話 cookie。

環境變量

可用工具

工作流運行

測試分析

使用情況與計費

組織

🔧 技術細節

此 MCP 使用 Blacksmith 的內部 Web API，該 API 未公開文檔。該 API 是從 Blacksmith 網頁應用逆向工程而來，可能會在未通知的情況下發生更改。

📄 許可證

本項目採用 MIT 許可證。

貢獻

歡迎貢獻代碼！請先打開一個 issue 討論提議的更改。

故障排除

會話過期

如果你看到 SESSION_EXPIRED，說明你的 Blacksmith 會話已過期。只需在 Chrome 中重新登錄 app.blacksmith.sh 並重試。

Cookie 提取失敗

自動提取 cookie 需要滿足以下條件：

• 安裝了 Chrome 的 macOS 系統
• 已在 Chrome 中登錄 Blacksmith
• Chrome 未使用鎖定的配置文件運行

如果提取失敗，請手動設置 BLACKSMITH_SESSION_COOKIE。

未設置組織

運行 list_orgs 查看可用組織，然後將 BLACKSMITH_ORG 設置為你的組織名稱。