Circleci MCP Server

CircleCI MCPサーバーは、モデルコンテキストプロトコル（MCP）に基づくサービスで、自然言語を使ってCircleCIプラットフォームと対話し、ビルドログの照会、不安定なテストの検出、設定の検証などの機能を実現します。

開発者ツールクラウドプラットフォーム #CI/CDツール #ビルドログ #テスト分析 #設定検証ローカル .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 34

更新時間 : 2025-04-28

CircleCI MCPサーバーとは？

CircleCI MCPサーバーは、Model Context Protocol（MCP）に基づく新しいプロトコルで、Cursor IDEや任意のMCPクライアントで自然言語を使ってCircleCIと統合し、タスクを実行できます。

CircleCI MCPサーバーの使い方は？

MCPサーバーをインストールし、MCPクライアントの設定に追加するだけで使用を開始できます。ビルド失敗ログの取得や不安定なテストの特定など、様々なツールがサポートされています。

適用シナリオ

CI/CDパイプラインの効率的なデバッグ、テストプロセスの最適化、開発効率の向上が必要なチームや個人に適しています。

主要機能

ビルド失敗ログを取得するCircleCIビルドから詳細な失敗ログを取得します。ビルドURLまたはローカルプロジェクトのコンテキストを指定することで実行できます。

不安定なテストを探す過去のテスト実行記録を分析して、プロジェクト内の不安定なテストを特定します。

設定ヘルパーCircleCI設定ファイルの検証と改善を支援します。構文チェックや提案を含みます。

利点と制限

利点

自然言語により複雑な操作を簡素化します。

CI/CDパイプラインの可視性と制御性を向上させます。

手動介入を減らし、開発効率を向上させます。

制限

有効なCircleCI APIトークンが必要です。

一部の高度な機能には特定の権限が必要な場合があります。

使い方

MCPサーバーをインストールする

リポジトリをクローンし、依存関係をインストールしてローカル環境を設定します。

サーバーを起動する

pnpmを使って開発モードでMCPサーバーを起動します。

クライアントを設定する

MCPサーバーをクライアントの設定ファイルに追加します。

使用例

直近の失敗したビルドのログを取得する「Get logs from https://app.circleci.com/pipelines/github/org/repo/123」のようなプロンプトを入力します。

プロジェクト内の不安定なテストを探す「Find flaky tests in my current project」のようなプロンプトを入力します。

よくある質問

CircleCI APIトークンを生成するにはどうすればいいですか？

MCPサーバーはカスタムドメインをサポートしていますか？

🚀 圈CI サーバー

圈CI サーバーは、MCP（機械学習構成プロトコル）に基づいて構築されたツールで、開発者に便利なCircleCI関連の機能サポートを提供することを目的としています。このサーバーは現在、以下のいくつかのツールを提供しています。

🚀 クイックスタート

このセクションでは、圈CI サーバーの基本的な使い方を説明します。

✨ 主な機能

サポートされているツール

ビルド失敗ログの取得
CircleCIからビルド失敗のログ情報を取得します。URLを直接使用する方法と、ローカルプロジェクト環境で使用する方法の両方をサポートしています。
flakes テストの検索
CircleCIプロジェクトの過去のテスト実行データを分析し、flaky（不安定）なテストケースを特定し、詳細情報を提供します。
構成アシスタント
CircleCI構成ファイルの作成を検証およびガイドし、開発者が構成エラーを回避し、構成の効率を向上させるのに役立ちます。

📦 インストール

リポジトリをクローンします:

git clone https://github.com/CircleCI-Public/mcp-server-circleci.git
cd mcp-server-circleci

依存関係をインストールします:
```
pnpm install
```
プロジェクトをビルドします:
```
pnpm build
```

📚 ドキュメント

開発ガイド

開発サーバーを起動します:

pnpm watch # ターミナルで実行し続けます

MCP Inspectorを使用してデバッグします
別のターミナルでInspectorを起動します:
```
pnpm inspector
```
- CIRCLECI_TOKENを環境変数に追加し、tokenがCircleCIプロジェクトにアクセスする権限を持っていることを確認します。
- オプション: CircleCIのベースURLを構成します。デフォルトはhttps//circleci.comです。

テストガイド

テストスイートを実行します:
```
pnpm test
```
開発モードでのリアルタイムテスト:
```
pnpm test:watch
```

詳細なコントリビューションガイドについては、CONTRIBUTING.mdを参照してください。

機能詳解

ビルド失敗ログの取得

このツールは以下の2つの使用方法をサポートしています:

CircleCI URLを直接使用して取得
例:"https://app.circleci.com/pipelines/github/org/repo/123のビルドログを取得する"
ローカルプロジェクト環境で使用
ワークスペースのルートパス、GitリモートURL、およびブランチ名を指定するだけです。

返されるログ情報には以下が含まれます: