Jenkins MCP

🚀 Jenkins MCP

Jenkins 操作管理のための MCP サーバーです。このサーバーは、Jenkins の操作管理を効率的に行うために設計されています。

🚀 クイックスタート

Jenkins MCP を使用することで、Jenkins の操作管理を容易に行うことができます。以下に、インストール方法や使用方法を説明します。

✨ 主な機能

• Jenkins ジョブの一覧表示
• ビルドのトリガー（オプションでパラメータを含む）
• ビルド状態の確認
• セキュアな API アクセスのための CSRF 粘性トークンの処理

📦 インストール

Smithery を通じたインストール

Smithery を通じて、Claude Desktop 用に Jenkins MCP を自動インストールするには、以下のコマンドを実行します。

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 サーバーは、CSRF 粘性トークンを 2 つの方法で処理します。

1. デフォルトモード：自動的に粘性トークンを取得し、ビルドリクエストに含めます。

   • セッションクッキーを使用して Web セッションを維持します。
   • すべての CSRF 保護を自動的に処理します。

2. API Token モード：Jenkins API トークンを使用します。これらのトークンは CSRF 保護の制限を受けません。

   • JENKINS_USE_API_TOKEN=true を設定します。
   • JENKINS_PASSWORD を API トークンに設定します。
   • Jenkins 2.96+ と互換性があり、このバージョンでは API トークン認証に粘性トークンは必要ありません。

Jenkins で API トークンを生成するには、ユーザー → 設定 → API トークン → 新しいトークンを追加 の手順で行います。

💻 使用例

基本的な使用法

# 依存関係のインストール
uv pip install -r requirements.txt

# Inspector を使用して開発モードで実行
mcp dev jenkins_mcp/server.py