Jenkins Mcp について
Jenkins MCPは、クライアントからJenkinsの操作を管理するMCPサーバーです。ジョブの一覧表示、パラメーター付きビルドの実行、状態確認に加え、CSRF保護にも対応します。
主な機能
- 01Jenkinsジョブの一覧表示
- 02任意のパラメーターでビルドを実行
- 03ビルド状態の確認
- 04CSRF crumbの処理
活用シーン
- 01Jenkinsのジョブを確認
- 02パラメーター付きビルドを開始
- 03ビルドの完了状況と状態を確認
- 04CSRF保護されたリクエストでJenkinsにアクセス
MCP 対応
MCPクライアントに、Jenkinsのジョブ一覧、ビルド実行、状態確認の操作を提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Jenkins MCP
インストール
Smithery 経由でインストール
Smithery 経由で Jenkins MCP を Claude Desktop に自動的にインストールするには:
npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude
手動でインストール
uvx install jenkins-mcp
設定
以下の JSON 設定スニペットを使って MCP サーバーを追加します:
{
"mcpServers": {
"jenkins-mcp": {
"command": "uvx",
"args": ["jenkins-mcp"],
"env": {
"JENKINS_URL": "https://your-jenkins-server/",
"JENKINS_USERNAME": "your-username",
"JENKINS_PASSWORD": "your-password",
"JENKINS_USE_API_TOKEN": "false"
}
}
}
}
CSRF クラムの処理
Jenkins は「クラム」と呼ばれるトークンを使って CSRF 保護を実装しています。これらのトークンは POST リクエストに含める必要があります。この MCP サーバーは、次の 2 つの方法で CSRF クラムを処理します:
-
デフォルトモード:ビルドリクエストに含める CSRF クラムを自動的に取得します
- セッション Cookie を使用してウェブセッションを維持します
- CSRF 保護をすべてバックグラウンドで処理します
-
API トークンモード:CSRF 保護の対象外となる Jenkins API トークンを使用します
JENKINS_USE_API_TOKEN=trueを設定しますJENKINS_PASSWORDにパスワードの代わりに API トークンを設定します- API トークン認証ではクラムが不要な Jenkins 2.96 以降で動作します
Jenkins で API トークンを生成するには、User → Configure → API Token → Add new Token に移動します。
機能
- Jenkins ジョブの一覧表示
- オプションのパラメーターを指定してビルドを実行
- ビルドステータスの確認
- 安全な API アクセスのための CSRF クラム処理
開発
# Install dependencies
uv pip install -r requirements.txt
# Run in dev mode with Inspector
mcp dev jenkins_mcp/server.py
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。