MCP Jenkins

by lanbaoshen

129 273 downloads Not rated yet MIT

About

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.

Details

License
MIT

Explore

- Bridges Jenkins with AI language models via the MCP specification.
- Supports stdio, SSE, and streamable-http transports.
- Provides over 30 Jenkins tools (jobs, nodes, builds, plugins, views, etc.).
- Includes a health check endpoint at /healthz.
- Supports read-only mode and SSL verification configuration.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Jenkins
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install MCP Jenkins using uv (recommended), pip, or Docker. Configure it with command-line arguments such as --jenkins-url, --jenkins-username, --jenkins-password, --transport (stdio, sse, or streamable-http), --read-only, and --jenkins-verify-ssl. Example configurations for JetBrains GitHub Copilot and VS Code Copilot Chat are provided in the README.

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.

| 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. |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp jenkins": {
            "mcp-jenkins": {
                "command": "uvx",
                "args": [
                    "mcp-jenkins",
                    "--transport",
                    "streamable-http"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-jenkins": {
        "command": "uvx",
        "args": [
            "mcp-jenkins",
            "--transport",
            "streamable-http"
        ]
    }
}
PyPI Version PyPI Downloads test codecov License

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.

Installation

Choose one of these installation methods: ```
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.