MCP Server Circleci

🚀 圈CIサーバー

CircleCIサーバーは、様々なツールをサポートするMCP（マルチ言語プラットフォーム計算）サーバーです。様々な開発環境に統合することで、開発者の作業効率を向上させることを目的としています。

🚀 クイックスタート

CircleCIサーバーは、多様な開発環境に統合できるMCPサーバーで、開発者の作業効率向上に役立ちます。以下に、主な機能と開発手順を説明します。

✨ 主な機能

サポートされる機能

構築失敗ログの取得

CircleCIから構築失敗のログを取得します。この機能には2つの使用方法があります。

1. CircleCIリンクの使用
   • 失敗したタスクリンクまたはパイプラインリンクを提供します。
   • 例：「https://app.circleci.com/pipelines/github/org/repo/123の構築ログを取得」
2. ローカルプロジェクトコンテキストの使用
   • ワークスペースのルートパス、GitリモートURL、ブランチ名を指定して、ローカルワークスペースから情報を取得します。
   • 例：「現在のブランチで最新の失敗したパイプラインを検索」

このツールは、以下を含む形式のログを返します。

• タスク名
• 実行ステップの詳細情報
• 失敗メッセージとコンテキスト

これは、構築失敗のデバッグ、テスト失敗の分析、デプロイ問題の調査、およびIDEを離れずに構築ログに迅速にアクセスするのに非常に役立ちます。

不安定なテストの検索

テスト実行履歴を分析して、CircleCIプロジェクト内の不安定なテストを特定します。この機能は、ここで説明されているCircleCIの不安定なテスト検出機能を利用しています：https://circleci.com/blog/introducing-test-insights-with-flaky-test-detection/#flaky-test-detection

このツールには2つの使用方法があります。

1. CircleCIプロジェクトリンクの使用
   • プロジェクトのリンクを直接提供します。
   • 例：「https://app.circleci.com/pipelines/github/org/repo内の不安定なテストを検索」
2. ローカルプロジェクトコンテキストの使用
   • ワークスペースのルートパスとGitリモートURLを指定して、ローカルワークスペースから情報を取得します。
   • 例：「現在のプロジェクト内の不安定なテストを検索」

ツールは、以下を含む詳細情報を返します。

• テスト名とファイル位置
• 失敗メッセージとコンテキスト

これは、以下に役立ちます。

• テストスイート内の不安定なテストを特定する
• テスト失敗に関する詳細なコンテキストを取得する
• テストの改善に関するデータ駆動型の決定を下す

設定アシスタント

CircleCIの設定タスクをガイドし、検証することで支援します。このツールは、以下のことを支援します。

1. CircleCI設定の検証
   • プロジェクトの.circleci/config.ymlファイルに構文またはセマンティックエラーがないかを確認します。
   • 例：「私のCircleCI設定を検証」

ツールは、以下を提供します。

• 詳細な検証結果
• 設定の提案

これは、以下に役立ちます。

• プッシュする前に設定エラーを検出する
• CircleCI設定のベストプラクティスを学ぶ
• 設定問題をデバッグする
• CircleCI機能を正しく実装する

📦 インストール

入門

1. リポジトリをクローンします。

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

2. 依存関係をインストールします。

pnpm install

3. プロジェクトをビルドします。

pnpm build

💻 使用例

基本的な使用法

MCPインスペクターを使用した開発

MCPサーバーを反復開発する最も簡単な方法は、MCPインスペクターを使用することです。MCPインスペクターの詳細については、https://modelcontextprotocol.io/docs/tools/inspector を参照してください。

1. 開発サーバーを起動します。

pnpm watch # このターミナルを実行したままにします

2. 別のターミナルでインスペクターを起動します。

pnpm inspector

3. 環境を設定します。

• インスペクターUIの「環境変数」セクションにCIRCLECI_TOKENを追加します。
• トークンは、CircleCIプロジェクトに対する読み取りアクセス権を持っている必要があります。
• オプションで、CircleCIのベースURLを設定することができます。デフォルトはhttps//circleci.comです。

テスト

• テストスイートを実行します。

pnpm test

• 開発中に監視テストを実行します。

pnpm test:watch

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