Currents MCP Server

Currents MCP サーバー

AI コーディングエージェントに、CI テスト結果を完全に可視化します。Currents MCP サーバーは、Cursor や Claude などのツールを Currents ダッシュボードに直接接続するため、エージェントはエディターを離れることなく、不安定なテストを診断し、失敗箇所を特定して、実際の実行データに基づいて対処できます。

• CI から実行、仕様ファイル、個々のテスト結果を取得します
• テストスイート全体のエラー傾向やパフォーマンス指標を表示します
• 隔離ルール、Webhook、プロジェクト設定をプログラムから管理します
• 推測ではなく、実際のテスト出力に基づいてエージェントが問題を修正できるようにします

ツール

Tool	Description
currents-list-actions	任意のフィルターを指定して、プロジェクトのすべてのアクションを一覧表示します。
currents-create-action	プロジェクトに新しいアクションを作成します。
currents-get-action	ID を指定して、単一のアクションを取得します。
currents-update-action	既存のアクションを更新します。
currents-delete-action	アクションを削除（アーカイブ）します。
currents-enable-action	無効化されたアクションを有効にします。
currents-disable-action	有効なアクションを無効にします。
currents-list-affected-tests	日付範囲を指定して、プロジェクト内でアクション（隔離、スキップ、タグ付け）の影響を受けたテストを一覧表示します。
currents-get-affected-test-executions	テストをキーとして、日付範囲内でアクションが適用されたそのテストの実行を、それぞれの実行、ブランチ、コミットとともに一覧表示します。
currents-get-action-executions	アクションをキーとして、日付範囲内で1つのルールが適用されたテスト実行を、そのルールが影響を及ぼしたすべてのテストにわたって一覧表示します。
currents-get-projects	Currents プラットフォームで利用可能なプロジェクトを取得します。
currents-get-project	ID を指定して、単一のプロジェクトを取得します。
currents-get-project-insights	日付範囲内のプロジェクトの実行およびテストの集計メトリクスを取得します。
currents-list-pull-requests	プロジェクトのプルリクエストカードを一覧表示します（実行は meta.pr.id でグループ化されます）。
currents-list-project-terms	1つのタイプ（タグ、ブランチ、authorName など）のプロジェクト用語を、カーソルページネーションで一覧表示します。
currents-create-jira-issue	組織の Jira 統合を使用して、実行内のテストから Jira 課題を作成します。
currents-link-jira-issue	組織の Jira 統合を使用して、既存の Jira 課題を実行内のテストにリンクします。
currents-list-jira-projects	組織の統合で利用可能な Jira プロジェクトを一覧表示します。
currents-list-jira-issue-types	Jira プロジェクトの Jira 課題タイプとカスタムフィールドを一覧表示します。
currents-get-runs	任意のフィルターを指定して、特定のプロジェクトの実行一覧を取得します。
currents-get-run-details	実行のステータス、コミット、ブランチ、グループ、スペックファイルを取得します。それぞれの instanceId と、レベル、タイプ、ソースごとの実行内ファイル数（attachmentCounts）も含まれます。
currents-find-run	クエリパラメーターを指定して、実行を検索します。
currents-cancel-run	進行中の実行をキャンセルします。
currents-reset-run	実行内の失敗したスペックファイルをリセットし、再実行できるようにします。
currents-delete-run	実行と関連するすべてのデータを削除します。
currents-cancel-run-github-ci	GitHub Actions のワークフロー実行 ID と試行番号を指定して、実行をキャンセルします。
currents-get-spec-instance	instanceId を指定して、1つのスペックファイル実行の生の結果を取得します。各テストの状態と試行、およびアーティファクトの URL が含まれます。
currents-get-spec-files-performance	日付範囲内の特定のプロジェクトのスペックファイルのパフォーマンスメトリクスを取得します。
currents-get-tests-performance	日付範囲内の特定のプロジェクトのテストメトリクスを集計して取得します。
currents-get-tests-signatures	プロジェクト、スペックファイルのパス、テストタイトルに基づいて、一意のテストシグネチャを生成します。
currents-get-test-results	特定のテストシグネチャの過去のテスト実行結果を取得します。
currents-get-context	CI でテストが失敗した理由を調べる場合や、修正する場合は、まずこれを呼び出してください。実行、スペックファイル（インスタンス）、または1つのテストに含まれる失敗したテストのエラー、ステップ、ファイルを返します。Currents ダッシュボードの「Fix」と同じ内容です。
currents-get-errors-explorer	日付範囲内のプロジェクトのエラーメトリクスを集計して取得します。
currents-get-test-evidence	CI 実行中にテストが生成したエビデンスアーティファクト（スクリーンショット、動画、トレース、添付ファイル）を収集し、テストごとにグループ化された署名付きダウンロード URL を取得します。
currents-create-evidence-links	Playwright のトレースから配信されるテスト試行のエビデンスへの共有可能なトレース API リンクを作成し、関連 URL を提供します。内容は、試行内容と失敗内容をまとめた Markdown 形式のトレース概要（digest URL）、フィルムストリップ、アニメーション付きスクリーンキャスト、DOM スナップショット、ネットワークリクエスト、添付ファイルです。
currents-create-session	操作したブラウザーセッションを Currents セッションとして記録し、そのエビデンスを読み取って共有できるようにします。
currents-add-attachments	currents-create-session で作成したセッション（sessionId を送信）または CI 実行（runId を送信）に、スペックファイル、テスト、または実行自体のログなどの添付ファイルを追加します。
currents-list-webhooks	プロジェクトのすべての Webhook を一覧表示します。
currents-create-share-link	サインインせずに誰でも開ける、期限付きのテスト結果への公開リンクを作成します。purpose "fix" は、テストを修正するエージェント向けの失敗コンテキストです。currents-get-context と同じ内容で、フレーキーテストも含まれ、フレーキーとしてマークされます。purpose "report" は、各テストとその試行、ファイルを人向けに一覧表示します。セッションの場合は、ステータス、エラー、添付ファイル、トレースを含むセッションページです。
currents-create-webhook	プロジェクトに新しい Webhook を作成します。
currents-get-webhook	ID を指定して、単一の Webhook を取得します。
currents-update-webhook	既存の Webhook を更新します。
currents-delete-webhook	Webhook を削除します。

スキル

AI エージェントに、複数ステップの Currents ワークフローを教えるエージェントスキルです。

スキル	説明
browser-evidence	実験的機能：実行できるテストがない場合に、自分で操作したブラウザーで変更が機能することを証明します。
collect-evidence	実装した作業が実際に機能することを示すか、デモします。Currents 経由で CI で実行されたテストの結果を使います。トレース概要、フィルムストリップ、アクセシビリティスナップショットをコメント内で確認できるトレース API リンクに加え、スクリーンショット、添付ファイル、動画が含まれます。
fix-failing-tests	Currents が記録した結果（エラー、ステップ、トレース、スクリーンショット、コンソール出力）を使って、CI で失敗したテストを修正します。

サーバーは各スキルを MCP リソースとして公開するため、接続したエージェントはローカルコピーがなくても一覧表示して読み取ることができます。

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

スキルをディスクからのみ読み込むエージェントには、引き続きコピーが必要です。スキルディレクトリをエージェントのスキル保存場所に配置してください（例：Claude Code の場合は .claude/skills/）。

セットアップ

API キー

こちらの手順に従って、Currents API キーを取得してください。

Cursor での使用方法

1. Cursor Settings > MCP > Enable に移動します
2. mcp.json に以下を追加します。

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

次のコマンドを実行して、Currents MCP を Claude Code に追加します。

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

Claude Desktop で Currents MCP を有効にするには、以下を追加します（claude_desktop_config.json ファイルを編集してください）。

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code と GitHub Copilot

VS Code にインストールすると、ホスト型サーバーが追加されます。初回接続時に VS Code が Currents のサインインページを開きます。入力する API キーはありません。

スキルとサーバーを追加するプラグインをインストールするには：

• VS Code：vscode://chat-plugin/install?source=currents-dev/currents-mcp を開きます

• Copilot CLI：

  copilot plugin marketplace add currents-dev/currents-mcp
  copilot plugin install currents@currents
  

Copilot CLI にサーバーのみを追加するには：

copilot mcp add --transport http currents https://mcp.currents.dev/mcp

リモート（ホスト型）MCP エンドポイント

上記のローカル stdio トランスポートに加え、同じサーバーをホスト型の Streamable HTTP エンドポイント（例：https://mcp.currents.dev/mcp）として実行し、Claude の Web／モバイルアプリなどのリモートコネクターから利用できます。

ホスト型サーバー自体は認証を一切行いません。各リクエストには Bearer トークンとして Currents API キーを含める必要があり、そのキーは Currents API に転送されます。

Authorization: Bearer <your-currents-api-key>

クライアント設定の例（リモートコネクター）：

{
  "mcpServers": {
    "currents": {
      "url": "https://mcp.currents.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

HTTP サーバーを自分で実行する場合：

# from the mcp-server package
npm run build && PORT=3000 npm run start:http
# or via Docker (serves /mcp, exposes the configured PORT)
docker build -t currents-mcp . && docker run -p 3000:3000 currents-mcp

Node サーバーは通常の HTTP を使用します。TLS とパブリックドメインは、コンテナの前段にあるリバースプロキシ／ロードバランサーで終端されます。死活監視用に GET /healthz エンドポイントが用意されています。

⚠️ 注意

AI ツール（MCP 経由など）を Currents に接続すると、それらのツールに API キー、テスト結果、CI メタデータへのアクセス権を付与することになります。使用する AI エージェントやサービスを精査し、データが安全に取り扱われるようにする責任は、利用者にあります。

References

• Currents
• Currents Documentation
• Contribution Guide
• Releasing and Publishing
• License