MCP Jenkins

🚀 MCP Jenkins

MCP Jenkins is an open - source implementation that connects Jenkins with AI language models following the Anthropic MCP specification, enabling secure and contextual AI interaction with Jenkins tools while maintaining data privacy and security.

🚀 Quick Start

The Model Context Protocol (MCP) is an open - source implementation that connects Jenkins with AI language models adhering to the Anthropic MCP specification. This project enables secure and contextual AI interaction with Jenkins tools while maintaining data privacy and security.

✨ Features

Cursor Demo

📦 Installation

Installation Methods

Choose one of the following installation methods:

# Using uv (Recommended)
pip install uv
uvx mcp-jenkins

# Using pip
pip install mcp-jenkins

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

Configuration and Usage

Cursor

1. Open Cursor settings.
2. Navigate to MCP.
3. Click + to add a new global MCP server.

This will create or edit the ~/.cursor/mcp.json file, which contains your MCP server configuration.

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

Standard Input Mode

# Standard input mode
uvx mcp-jenkins --jenkins-url=xxx --jenkins-username=xxx --jenkins-password=xxx

# Interactive console mode (Optional)
uvx mcp-jenkins --console

Script Mode

from mcp_jenkins import JenkinsMCP

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

# Execute a build job
result = jenkins.build_job("my-job")
print(result)

💻 Usage Examples

Tool List

The following are some available tools:

1. build_job: Build a specified Jenkins job.
2. get_build_status: Get the build status of a specified job.
3. trigger_build: Trigger a new build job.

🔧 Technical Details

Development and Debugging

Pre - commit Hooks

# Install dependencies
uv sync --all-extras --dev
pre-commit install

# Manually execute
pre-commit run --all-files

Unit Tests

# Install dependencies
uv sync --all-extras --dev

# Execute unit tests
uv run pytest --cov=mcp_jenkins

📄 License

This project is licensed under the MIT License. See the LICENSE file for details. This is not an official Jenkins product.