mcp-jenkins

Name: mcp-jenkins
Author: lanbaoshen

Verified

The Model Context Protocol (MCP) is an open-source implementation that bridges Jenkins with AI language models following Anthropic's MCP specification. This project enables secure, contextual AI interactions with Jenkins tools while maintaining data privacy and security.

129stars

57forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/lanbaoshen/mcp-jenkins

Getting Started

Guides for using mcp servers skills like mcp-jenkins.

Best MCP Servers in 2026
Category-by-category picks: databases, dev tools, productivity, browser automation.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T16:24:03.120Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is mcp-jenkins?

mcp-jenkins is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by lanbaoshen. The Model Context Protocol (MCP) is an open-source implementation that bridges Jenkins with AI language models following Anthropic's MCP specification. This project enables secure, contextual AI interactions with Jenkins tools while maintaining data privacy and security. It has 129 GitHub stars.

Is mcp-jenkins safe to use?

Yes. mcp-jenkins passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install mcp-jenkins?

Clone the repository with "git clone https://github.com/lanbaoshen/mcp-jenkins" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is mcp-jenkins written in?

mcp-jenkins is primarily written in Python. It is open-source under lanbaoshen on GitHub, so you can review or fork the full source.

Are there alternatives to mcp-jenkins?

Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh mcp-jenkins against similar tools.

MCP for Beginners

Build MCP servers that give AI assistants real capabilities

36 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

n8n

by n8n-io

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

193,114

spring-ai aws-cost-explorer-mcp-server

MCP Jenkins

PyPI Version License

Installation

Choose one of these installation methods:

# Using uv (recommended)
pip install uv
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

Line Arguments

When using command line arguments, you can specify the Jenkins server details as follows:

# Simple streamable-http example
uvx mcp-jenkins --transport streamable-http

Argument	Description	Required
`--jenkins-url`	The URL of the Jenkins server. (Http app can set it via headers `x-jenkins-url`)	No
`--jenkins-username`	The username for Jenkins authentication. (Http app can set it via headers `x-jenkins-username`)	No
`--jenkins-password`	The password or API token for Jenkins authentication. (Http app can set it via headers `x-jenkins-password`)	No
`--jenkins-timeout`	Timeout for Jenkins API requests in seconds. Default is `5` seconds.	No
`--jenkins-verify-ssl/--no-jenkins-verify-ssl`	Whether to verify SSL certificates when connecting to Jenkins. Default is to verify.	No
`--jenkins-session-singleton/--no-jenkins-session-singleton`	Whether to use a singleton Jenkins client for all requests in the same session. Default is True.	No
`--read-only`	Whether to enable read-only mode. Default is False	No
`--transport`	Transport method to use for communication. Options are `stdio`, `sse` or `streamable-http`. Default is `stdio`.	No
`--host`	Host address for `streamable-http` transport. Default is `0.0.0.0`	No
`--port`	Port number for `streamable-http` transport. Default is `9887`.	No

Configuration and Usage

Jetbrains Github Copilot

Open Jetbrains Settings
Navigate to Github Copilot > MCP > Configure
Add the following configuration:

{
  "servers": {
    "my-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-jenkins",
        "--jenkins-url=xxx",
        "--jenkins-username=xxx",
        "--jenkins-password=xxx"
      ]
    }
  }
}

VSCode Copilot Chat

Create .vscode folder with mcp.json file in you workspace for local setup or edit settings.json trough settings menu.
Insert the following configuration:

SSE mode

{
    "servers": {
        "jenkins": {
            "url": "http://localhost:9887/sse",
            "type": "sse"
        }
    }
}

Streamable-Http mode

{
    "servers": {
        "mcp-jenkins-mcp": {
            "autoApprove": [],
            "disabled": false,
            "timeout": 60,
            "type": "streamableHttp",
            "url": "http://localhost:9887/mcp"
        }
    }
}

Run the Jenkins MCP server with the following command:

uvx mcp-jenkins \
  --jenkins-url xxx \
  --jenkins-username xxx  \
  --jenkins-password xxx \
  --transport sse

Health Check Endpoint

When running with --transport streamable-http or --transport sse, the server exposes a plain HTTP liveness endpoint:

GET /healthz  ->  200 OK

It always returns 200 and bypasses the x-jenkins-* auth headers, so it is safe to use directly as a Kubernetes liveness/readiness probe without any Jenkins credentials. Example probe:

livenessProbe:
  httpGet:
    path: /healthz
    port: 9887
  initialDelaySeconds: 5
  periodSeconds: 10

Note: this is a liveness check only — it does not verify connectivity to the upstream Jenkins server.

Available Tools

Tool	Description
`get_item`	Get a specific item by name.
`get_item_config`	Get the configuration of a specific item.
`get_item_parameters`	Get the parameters of a specific item.
`get_all_items`	Get all items in Jenkins.
`query_items`	Query items based on pattern.
`build_item`	Build a item.
`get_all_nodes`	Get all nodes in Jenkins.
`get_node`	Get a specific node by name.
`get_node_config`	Get the configuration of a specific node.
`get_all_queue_items`	Get all queue items in Jenkins.
`get_queue_item`	Get a specific queue item by ID.
`cancel_queue_item`	Cancel a specific queue item by ID.
`get_build`	Get a specific build by job name and build number.
`get_build_scripts`	Get scripts associated with a specific build.
`get_build_console_output`	Get the console output of a specific build.
`get_build_parameters`	Get the parameters of a specific build.
`get_build_test_report`	Get the test report of a specific build.
`get_running_builds`	Get all currently running builds in Jenkins.
`stop_build`	Stop a specific build by job name and build number.
`get_all_build_artifacts`	List the artifacts of a specific build.
`get_build_artifact`	Download an artifact from a specific build.
`get_build_artifact_url`	Get the direct URL of an artifact from a specific build.
`get_view`	Get a specific view by name.
`get_all_views`	Get the configuration of a specific view.
`get_all_plugins`	Get all installed plugins.
`get_plugin`	Get a specific plugin by short name.
`get_plugins_with_problems`	Get plugins with problems (missing dependencies, version mismatch, etc.).
`get_plugins_with_backup`	Get plugins that can be downgraded.
`get_plugins_with_updates`	Get plugins that have available updates.
`get_plugin_dependency_graph`	Get dependency graph for a plugin in Graphviz format.
`run_groovy_script`	Execute an arbitrary Groovy script on Jenkins.

mcp-jenkins

Frequently Asked Questions

What is mcp-jenkins?

Is mcp-jenkins safe to use?

How do I install mcp-jenkins?

What programming language is mcp-jenkins written in?

Are there alternatives to mcp-jenkins?

Related Skills

MCP Jenkins

Installation

Line Arguments

Configuration and Usage

Jetbrains Github Copilot

VSCode Copilot Chat

Health Check Endpoint

Available Tools

Contributing

License

Star History