MCP Jenkins

🚀 MCP Jenkins

MCP Jenkins是一個開源實現，它將Jenkins與遵循Anthropic MCP規範的AI語言模型連接起來，使安全、上下文化的AI與Jenkins工具交互成為可能，同時能保持數據隱私和安全性。

🚀 快速開始

本項目可將Jenkins與遵循Anthropic MCP規範的AI語言模型相連接，下面為您介紹其安裝和使用方法。

✨ 主要特性

• 實現Jenkins與遵循Anthropic MCP規範的AI語言模型的連接。
• 支持安全、上下文化的AI與Jenkins工具交互，保障數據隱私和安全性。
• 提供多種安裝方式和使用模式，如Cursor模式、標準輸入模式和腳本模式。

📦 安裝指南

安裝方法

您可以選擇以下其中一種安裝方式：

# 使用uv（推薦）
pip install uv
uvx mcp-jenkins

# 使用pip
pip install mcp-jenkins

# 使用Smithery
npx -y @smithery/cli@latest install @lanbaoshen/mcp-jenkins --client claude

配置與使用

Cursor

1. 打開Cursor設置。
2. 導航到MCP。
3. 點擊+添加新的全局MCP服務器。

這將創建或編輯~/.cursor/mcp.json文件，其中包含您的MCP服務器配置。

{
  "mcpServers": {
    "mcp-jenkins": {
      "command": "uvx",
      "args": [
        "mcp-jenkins",
        "--jenkins-url=xxx",
        "--jenkins-username=xxx",
        "--jenkins-password=xxx"
      ]
    }
  }
}

標準輸入模式

# 標準輸入模式
uvx mcp-jenkins --jenkins-url=xxx --jenkins-username=xxx --jenkins-password=xxx

# 交互式控制檯模式（可選）
uvx mcp-jenkins --console

腳本模式

from mcp_jenkins import JenkinsMCP

jenkins = JenkinsMCP(
    jenkins_url="http://your-jenkins-url:8080",
    username="your-username",
    password="your-password"
)

# 執行構建作業
result = jenkins.build_job("my-job")
print(result)

💻 使用示例

基礎用法

以下是使用腳本模式執行構建作業的示例：

from mcp_jenkins import JenkinsMCP

jenkins = JenkinsMCP(
    jenkins_url="http://your-jenkins-url:8080",
    username="your-username",
    password="your-password"
)

# 執行構建作業
result = jenkins.build_job("my-job")
print(result)

高級用法

您可以根據需要調用不同的工具，如獲取構建狀態、觸發新的構建作業等。

from mcp_jenkins import JenkinsMCP

jenkins = JenkinsMCP(
    jenkins_url="http://your-jenkins-url:8080",
    username="your-username",
    password="your-password"
)

# 獲取指定作業的構建狀態
status = jenkins.get_build_status("my-job")
print(status)

# 觸發新的構建作業
jenkins.trigger_build("my-job")

📚 詳細文檔

工具列表

以下是一些可用的工具：

1. build_job：構建指定的Jenkins作業。
2. get_build_status：獲取指定作業的構建狀態。
3. trigger_build：觸發新的構建作業。

🔧 技術細節

開發與調試

預提交鉤

# 安裝依賴項
uv sync --all-extras --dev
pre-commit install

# 手動執行
pre-commit run --all-files

單元測試

# 安裝依賴項
uv sync --all-extras --dev

# 執行UT
uv run pytest --cov=mcp_jenkins

📄 許可證

本項目根據MIT許可證發佈，詳情見LICENSE文件。需要注意的是，這不是官方的Jenkins產品。

Cursor Demo