詹金斯 MCP

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

安装

通过 Smithery 安装

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

npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude

手动安装

uvx install jenkins-mcp

Related MCP server: kom

配置

使用以下 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 使用“crumbs”实现 CSRF 防护 - 即 POST 请求中必须包含的令牌。本 MCP 服务器通过两种方式处理 CSRF crumbs：

1. 默认模式：自动获取并包含带有构建请求的 CSRF 信息

   • 使用会话 cookie 来维护网络会话

   • 处理幕后的所有 CSRF 保护

2. API 令牌模式：使用不受 CSRF 保护的 Jenkins API 令牌

   • 设置JENKINS_USE_API_TOKEN=true

   • 将JENKINS_PASSWORD设置为您的 API 令牌而不是密码

   • 适用于 Jenkins 2.96+，不需要 crumbs 进行 API 令牌认证

您可以在 Jenkins 中生成 API 令牌：用户 → 配置 → API 令牌 → 添加新令牌

特征

• 列出 Jenkins 职位

• 使用可选参数触发构建

• 检查构建状态

• CSRF crumb 处理，实现安全 API 访问

发展

# Install dependencies
uv pip install -r requirements.txt

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