Jenkins MCP

🚀 Jenkins MCP

Jenkins MCP 是用於 Jenkins 操作管理的 MCP 服務器，可助力高效管理 Jenkins 相關操作。

🚀 快速開始

你可以按照以下步驟完成 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 服務器以兩種方式處理 CSRF 粘性令牌：

1. 默認模式：自動獲取幷包含粘性令牌到構建請求中

   • 使用會話 cookie 維護 Web 會話
   • 在幕後處理所有 CSRF 保護

2. API Token 模式：使用 Jenkins API 令牌，這些令牌不受 CSRF 保護限制

   • 設置 JENKINS_USE_API_TOKEN=true
   • 設置 JENKINS_PASSWORD 為你的 API 令牌而不是密碼
   • 與 Jenkins 2.96+ 兼容，該版本不需要粘性令牌進行 API 令牌身份驗證

你可以在 Jenkins 中生成 API 令牌：用戶 → 配置 → API 令牌 → 添加新令牌

✨ 主要特性

• 列出 Jenkins 作業
• 觸發構建並可選包含參數
• 檢查構建狀態
• 處理 CSRF 粘性令牌以實現安全的 API 訪問

💻 使用示例

開發

# 安裝依賴項
uv pip install -r requirements.txt

# 使用 Inspector 以開發模式運行
mcp dev jenkins_mcp/server.py