Jenkins Api MCP Server

🚀 Jenkins API MCP サーバー

このサービスは Spring AI をベースにした MCP サービスで、Jenkins REST API 呼び出しを処理し、Jenkins ジョブを管理するための一般的な操作インターフェースを提供します。

✨ 主な機能

• ジョブ管理：ジョブの作成、削除、有効化/無効化、名前の変更
• ジョブビルド：ビルドのトリガー、パラメータ付きビルド、ビルドの停止
• ジョブ情報：ジョブ情報、ビルド情報、ビルドログの取得
• ジョブ設定：ジョブ設定の取得と更新

🔧 技術詳細

• Spring Boot 3.3.6
• Jenkins REST API クライアント
• Spring AI MCP Server

🚀 クイックスタート

前提条件

• JDK 17 以上のバージョン
• Maven 3.6 以上のバージョン
• “リモートアクセス API” が有効になっている Jenkins サーバー

プロジェクトのビルド

リポジトリをクローンし、プロジェクトディレクトリに移動します：

git clone [仓库地址]
cd jenkins-mcp-server

プロジェクトを実行する前に、Maven を使用してビルドします：

mvn package

ビルドが成功すると、/target ディレクトリに mcp-jenkins-server-0.0.1-SNAPSHOT.jar という名前のファイルが生成されます。この完全パスを mcp.json 構成ファイルに追加します：

{your_path}\\mcp-jenkins-server-0.0.1-SNAPSHOT.jar

mcp.json の設定

{
  "mcpServers": {
    "jenkins-mcp": {
      "command": "java",
      "args": [
        "-jar",
        "{your_path}\\mcp-jenkins-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "JENKINS_API_SERVER_URI": "jenkins-uri",
        "JENKINS_API_USERNAME": "用户名", 
        "JENKINS_API_TOKEN": "密码/令牌"
      }
    }
  }
}

📚 ドキュメント

ジョブ管理

• createJob：新しい Jenkins ジョブを作成します。
• deleteJob：既存の Jenkins ジョブを削除します。
• enableJob：無効になっている Jenkins ジョブを有効にします。
• disableJob：有効になっている Jenkins ジョブを無効にします。
• renameJob：既存の Jenkins ジョブの名前を変更します。

ジョブビルド

• buildJob：ジョブのビルドをトリガーします。
• buildJobWithParams：パラメータ付きでビルドをトリガーします。
• killJob：実行中のビルドを停止します。

ジョブ情報

• getJobInfo：ジョブの詳細情報を取得します。
• getBuildInfo：特定のビルドの情報を取得します。
• getBuildLog：ビルドのコンソール出力ログを取得します。
• getLastBuildNumber：最後のビルド番号を取得します。
• getLastBuildTimestamp：最後のビルドのタイムスタンプを取得します。

ジョブ設定

• getJobConfig：ジョブの設定 XML を取得します。
• updateJobConfig：ジョブの設定を更新します。