Currents

Currents MCP サーバー

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

• CIから実行、スペックファイル、個々のテスト結果をクエリ
• テストスイート全体のエラー傾向とパフォーマンスメトリクスを表示
• 検疫ルール、ウェブフック、プロジェクト設定をプログラムで管理
• 推測ではなく実際のテスト出力を使用して、エージェントが壊れたものを修正できるようにする

ツール

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	日付範囲内で、プロジェクトのアクション（quarantine、skip、tag）によって影響を受けるテストを一覧表示します。
currents-get-affected-test-executions	テストをキーとして、日付範囲内でアクションが適用された 1 つのテストの実行を、各実行の run、branch、commit とともに一覧表示します。
currents-get-action-executions	アクションをキーとして、日付範囲内で 1 つのルールが適用されたテスト実行を、影響を受けたすべてのテストにわたって一覧表示します。
currents-get-projects	Currents プラットフォームで利用可能なプロジェクトを取得します。
currents-get-project	ID で単一のプロジェクトを取得します。
currents-get-project-insights	日付範囲内のプロジェクトの集計された run およびテストメトリクスを取得します。
currents-list-pull-requests	プロジェクトのプルリクエストカードを一覧表示します（meta.pr.id でグループ化された実行）。
currents-list-project-terms	1 つのタイプ（tag、branch、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	特定のテスト実行の詳細を取得します。
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 によるテストスペックファイルの特定の実行からデバッグデータを取得します。
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トレースから提供され、その上のURLも含みます：試行が行ったことと失敗した内容のMarkdownダイジェスト、フィルムストリップ、アニメーションスクリーンキャスト、DOMスナップショット、ネットワークリクエスト、添付ファイル。
currents-create-session	自分が操作したブラウザセッションをCurrents実行として記録し、その証跡をCI実行と同様に読み取り・共有できるようにします。
currents-list-webhooks	プロジェクトのすべてのウェブフックを一覧表示します。
currents-create-share-link	サインインせずに誰でも開けるテスト結果への公開リンクを作成します（有効期限まで）。purpose "fix" は失敗コンテキストで、テストを修正するエージェント向けです — currents-get-contextと同じ内容で、フレークテストを含みフレークとしてマークされます。purpose "report" は各テストを試行とファイルとともに一覧表示し、人向けです。
currents-create-webhook	プロジェクトに新しいウェブフックを作成します。
currents-get-webhook	IDで単一のウェブフックを取得します。
currents-update-webhook	既存のウェブフックを更新します。
currents-delete-webhook	ウェブフックを削除します。

スキル

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

スキル	説明
browser-evidence	実験的。
collect-evidence	実装した作業が実際に機能することを示す、またはデモする。Currentsを介してCIで実行されたテストから、ダイジェスト、フィルムストリップ、アクセシビリティスナップショットがコメント内で読めるトレースリンクに加え、スクリーンショット、添付ファイル、動画を含む。
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設定 > MCP > 有効にする に移動します
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"
      }
    }
  }
}

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

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

ホステッドサーバーは独自の認証を実行しません。各リクエストには Currents APIキーをBearerトークンとして含める必要があり、これは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とパブリックドメインは コンテナの前にあるリバースプロキシ/ロードバランサーで終端されます。livenessチェック用に GET /healthzエンドポイントが提供されています。

⚠️ 注意

AIツール（例：MCP経由）をCurrentsに接続することで、それらにAPIキー、テスト結果、CIメタデータへのアクセスを許可することになります。使用するAIエージェントやサービスを審査し、データを安全に取り扱うことを確認するのは、あなたの責任です。

参照

• Currents
• Currentsドキュメント
• コントリビューションガイド
• リリースと公開
• ライセンス