MCP Jenkins
@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.
Overview
What is MCP Jenkins?
MCP Jenkins is an open-source implementation of the Model Context Protocol (MCP) that bridges Jenkins with AI language models following Anthropic’s MCP specification. It enables secure, contextual AI interactions with Jenkins tools while maintaining data privacy and security. It is intended for users who want to control or query a Jenkins server through an AI assistant.
How to use MCP Jenkins?
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.
Key features of MCP Jenkins
- 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.
Use cases of MCP Jenkins
- List Jenkins jobs, builds, nodes, and plugins through an AI chat interface.
- Trigger builds, stop builds, and manage queue items using natural language.
- Retrieve build console output, artifacts, and test reports.
- Execute Groovy scripts on Jenkins for advanced automation.
FAQ from MCP Jenkins
What authentication methods are supported?
MCP Jenkins supports Jenkins username and password (or API token) authentication via the --jenkins-username and --jenkins-password arguments, or through HTTP headers x-jenkins-username and x-jenkins-password.
What transport types are available?
Three transport types are available: stdio (default), sse, and streamable-http. The transport is set with the --transport argument.
Can I run MCP Jenkins in read-only mode?
Yes. Use the --read-only flag to enable read-only mode, which prevents any write operations to Jenkins.
Is MCP Jenkins an official Jenkins product?
No. MCP Jenkins is licensed under MIT and is not an official Jenkins product.
