Jenkins Mcp

English | 中文

Jenkins API MCP サーバー

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

機能

• ジョブ管理：ジョブの作成、削除、有効化／無効化、名前の変更
• ジョブのビルド：ビルドの実行、パラメーターを指定したビルド、ビルドの停止
• ジョブ情報：ジョブ情報、ビルド情報、ビルドログの取得
• ジョブ設定：ジョブ設定の取得と更新

技術スタック

• Spring Boot 3.3.6
• Jenkins REST API Client
• Spring AI MCP Server

クイックスタート

必要条件

• JDK 17+
• Maven 3.6+
• Jenkins サーバー（「Remote Access API」が有効になっていること）

プロジェクトのビルド

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

git clone [repository-url]
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": "username", 
        "JENKINS_API_TOKEN": "password/token"
      }
    }
  }
}

API ドキュメント

ジョブ管理

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

ジョブのビルド

• buildJob ：Jenkins ジョブのビルドを実行します
• buildJobWithParams ：パラメーターを指定してビルドを実行します
• killJob ：実行中のビルドを停止します

ジョブ情報

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

ジョブ設定

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