mcpField
J
Jenkins Mcp

Jenkins Mcp

本地服务
github.com/kjozsa云与基础设施1081 周前更新
代码仓库

关于 Jenkins Mcp

Jenkins MCP 是用于管理 Jenkins 操作的 MCP 服务，面向需要从客户端查看和触发构建的用户。它支持列出任务、触发带参数的构建及检查状态，并处理 CSRF 防护。

主要功能

  1. 01列出 Jenkins 任务
  2. 02触发可选参数的构建
  3. 03检查构建状态
  4. 04处理 CSRF crumb

适用场景

  1. 01查看 Jenkins 中的任务
  2. 02启动带参数的构建
  3. 03检查构建是否完成及其状态
  4. 04通过受 CSRF 保护的请求访问 Jenkins

MCP 相关

该服务向 MCP 客户端提供 Jenkins 任务列表、构建触发和状态检查操作。

#jenkins#mcp#build-management

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "jenkins": {
      "command": "uvx",
      "args": [
        "jenkins-mcp"
      ],
      "env": {
        "JENKINS_URL": "<JENKINS_URL>",
        "JENKINS_USERNAME": "<JENKINS_USERNAME>",
        "JENKINS_PASSWORD": "<JENKINS_PASSWORD>"
      }
    }
  }
}
启动命令uvx jenkins-mcp
需要配置的环境变量
JENKINS_URL
JENKINS_USERNAME
JENKINS_PASSWORD密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypijenkins-mcp

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Jenkins MCP

smithery badge 用于管理 Jenkins 操作的 MCP 服务。

Jenkins MCP 服务

安装

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Jenkins MCP：

npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude
手动安装
uvx install jenkins-mcp

配置

使用以下 JSON 配置片段添加 MCP 服务：

{
  "mcpServers": {
    "jenkins-mcp": {
      "command": "uvx",
      "args": ["jenkins-mcp"],
      "env": {
        "JENKINS_URL": "https://your-jenkins-server/",
        "JENKINS_USERNAME": "your-username",
        "JENKINS_PASSWORD": "your-password",
        "JENKINS_USE_API_TOKEN": "false"
      }
    }
  }
}

CSRF Crumb 处理

Jenkins 使用“crumb”实现 CSRF 保护——这些令牌必须包含在 POST 请求中。此 MCP 服务通过两种方式处理 CSRF crumb：

  1. 默认模式：自动获取 CSRF crumb 并将其包含在构建请求中

    • 使用会话 Cookie 维持 Web 会话
    • 在后台处理所有 CSRF 保护工作

  2. API Token 模式：使用不受 CSRF 保护限制的 Jenkins API Token

    • 设置 JENKINS_USE_API_TOKEN=true
    • 将 JENKINS_PASSWORD 设置为 API Token，而非密码
    • 适用于 Jenkins 2.96 及更高版本，这些版本的 API Token 身份验证无需 crumb

你可以在 Jenkins 中通过以下路径生成 API Token：用户 → 配置 → API Token → 添加新 Token

功能

  • 列出 Jenkins 作业
  • 触发带可选参数的构建
  • 检查构建状态
  • 处理 CSRF crumb，以安全访问 API

开发

# Install dependencies
uv pip install -r requirements.txt

# Run in dev mode with Inspector
mcp dev jenkins_mcp/server.py

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。