Blacksmith MCP

🚀 Blacksmith MCP

このMCPサーバーは、ClaudeをBlacksmith CIのデータに接続します。自然な会話を通じて、ワークフローの実行状況を照会し、テストの失敗を分析し、不安定なテストを検出し、使用状況を監視することができます。

🚀 クイックスタート

ChromeでBlacksmithにログインしている場合はゼロコンフィグです。

# Claude Codeに追加
claude mcp add blacksmith -- npx blacksmith-mcp

# 組織を設定する（1回実行）
export BLACKSMITH_ORG="your-org-name"

MCPは自動的にChromeのクッキーからセッションを抽出します。手動でトークンをコピーする必要はありません。

✨ 主な機能

このMCPを使用することで、CIの失敗をデバッグする際に、ダッシュボードをクリックして実行IDをコピーし、複数のページにまたがる情報をまとめる必要がなくなります。自然な会話で以下のような質問ができます。

• "最後のCI実行が失敗した理由は何ですか？"
• "今週不安定なテストはどれですか？"
• "mainブランチと自分のPRのテスト失敗を比較してください"
• "最も多くのキャッシュストレージを使用しているものは何ですか？"

ClaudeがAPI呼び出しを処理し、実行可能な洞察を提供します。

📦 インストール

オプション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

📚 ドキュメント

認証

自動（推奨）: Chromeでapp.blacksmith.shにログインします。MCPは自動的にセッションクッキーを抽出します。

手動: BLACKSMITH_SESSION_COOKIE環境変数にセッションクッキーの値を設定します。

環境変数

利用可能なツール

ワークフロー実行

テスト分析

使用状況と請求

組織

💻 使用例

失敗した実行のデバッグ

あなた: 最後の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: PRの実行とベースブランチを使用して compare_test_runs を使用

あなたのPRで2件の新しい失敗が発生しました。

• UserProfile.test.tsx: "Cannot read property 'avatar' of undefined"
• api/users.test.ts: 期待値200、実際の値404

以前に失敗していた5件のテストが現在合格しています（素晴らしい！）。

🔧 開発

# 依存関係のインストール
pnpm install

# ビルド
pnpm build

# 開発モード（監視）
pnpm dev

# MCPインスペクターでテスト
npx @modelcontextprotocol/inspector node dist/index.js

トラブルシューティング

セッション期限切れ

SESSION_EXPIRED が表示された場合は、あなたのBlacksmithセッションが期限切れになっています。Chromeでapp.blacksmith.shに再度ログインしてから再試行してください。

クッキー抽出失敗

自動クッキー抽出には以下が必要です。

• ChromeがインストールされたmacOS
• ChromeでBlacksmithにログインしていること
• Chromeがロックされたプロファイルで実行されていないこと

抽出に失敗した場合は、手動で BLACKSMITH_SESSION_COOKIE を設定してください。

組織が設定されていない

list_orgs を実行して利用可能な組織を確認し、BLACKSMITH_ORG をあなたの組織名に設定してください。

APIに関する注意

このMCPはBlacksmithの内部Web APIを使用していますが、これは文書化されていません。APIはBlacksmithのWebアプリから逆エンジニアリングされたもので、予告なく変更される可能性があります。

📄 ライセンス

MIT

コントリビューション

コントリビューションは大歓迎です！提案された変更について議論するために、まずIssueを開いてください。