Jenkins MCP Server

This page documents the community server lanbaoshen/mcp-jenkins. It is published on PyPI as mcp-jenkins and as the container image ghcr.io/lanbaoshen/mcp-jenkins.

The server bridges Jenkins with MCP clients, covering jobs, builds, queues, nodes, views, and plugins.

What it Does

• Job inspection: List and query items, read item configuration and parameters
• Build control: Trigger builds, stop builds, and inspect running builds
• Log access: Retrieve build console output
• Queue management: List, inspect, and cancel queue items
• Node and view inspection: List nodes, node configuration, and views
• Plugin inspection: List installed plugins and available updates

Installation

# Using uv (recommended)
uvx mcp-jenkins

# Using pip
pip install mcp-jenkins
mcp-jenkins

Docker:

docker pull ghcr.io/lanbaoshen/mcp-jenkins:latest
docker run -p 9887:9887 --rm ghcr.io/lanbaoshen/mcp-jenkins:latest --transport streamable-http

Configuration

{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": ["mcp-jenkins"],
      "env": {
        "JENKINS_URL": "https://jenkins.example.com",
        "JENKINS_USERNAME": "alice",
        "JENKINS_PASSWORD": "your-api-token"
      }
    }
  }
}

JENKINS_PASSWORD accepts a password or an API token. The server also supports JENKINS_TIMEOUT and JENKINS_VERIFY_SSL.

Available Tools

The full tool list is in the upstream README.

Common Workflows

Debugging a Failed Build

1. Use get_all_items or query_items to find the job
2. Use get_build to get the failed build
3. Use get_build_console_output to retrieve the console log
4. Ask "Summarize what caused this build failure based on the log"

Monitoring Running Builds

1. Use get_running_builds to list active builds
2. Use get_all_queue_items to check queued items
3. Use get_build to inspect a specific build
4. Use get_build_console_output for progress details
5. Notify the team when the build completes

Jenkins Health Check

1. Use get_all_nodes to list agent nodes
2. Use get_node and get_node_config to inspect a specific node
3. Use get_plugins_with_updates to review available updates
4. Generate a Jenkins infrastructure health report

Example Prompts

• "Show me the last 5 builds for the api-service job"
• "Why did build #1234 fail?"
• "Trigger the deploy-to-staging job"
• "Show the console output for the latest build"
• "List all items in the frontend folder"
• "Which Jenkins agents are currently offline?"

Troubleshooting

Security Notes

• Use an API token instead of a password
• Keep certificate verification enabled unless you have a specific reason to disable it
• Use a dedicated Jenkins account with minimal permissions
• Use HTTPS for the Jenkins URL

Sources

• https://github.com/lanbaoshen/mcp-jenkins
• https://pypi.org/project/mcp-jenkins/