mcpField
J
Jenkins Mcp

Jenkins Mcp

ローカル
github.com/kjozsaクラウド・インフラ1081 週間前に更新

Jenkins Mcp について

Jenkins MCPは、クライアントからJenkinsの操作を管理するMCPサーバーです。ジョブの一覧表示、パラメーター付きビルドの実行、状態確認に加え、CSRF保護にも対応します。

主な機能

  1. 01Jenkinsジョブの一覧表示
  2. 02任意のパラメーターでビルドを実行
  3. 03ビルド状態の確認
  4. 04CSRF crumbの処理

活用シーン

  1. 01Jenkinsのジョブを確認
  2. 02パラメーター付きビルドを開始
  3. 03ビルドの完了状況と状態を確認
  4. 04CSRF保護されたリクエストでJenkinsにアクセス

MCP 対応

MCPクライアントに、Jenkinsのジョブ一覧、ビルド実行、状態確認の操作を提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"jenkins": {
"command": "uvx",
"args": [
"jenkins-mcp"
],
"env": {
"JENKINS_URL": "<JENKINS_URL>",
"JENKINS_USERNAME": "<JENKINS_USERNAME>",
"JENKINS_PASSWORD": "<JENKINS_PASSWORD>"
}
}
}
}
起動コマンドuvx jenkins-mcp
設定が必要な環境変数
JENKINS_URL
JENKINS_USERNAME
JENKINS_PASSWORDシークレット

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypijenkins-mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Jenkins MCP

smithery badge Jenkins の操作を管理する MCP サーバーです。

Jenkins MCP server

インストール

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 クラムを処理します:

  1. デフォルトモード:ビルドリクエストに含める CSRF クラムを自動的に取得します

    • セッション Cookie を使用してウェブセッションを維持します
    • CSRF 保護をすべてバックグラウンドで処理します
  2. 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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。