詹金斯 MCP
用于管理 Jenkins 操作的 MCP 服务器。
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 Jenkins MCP:
npx -y @smithery/cli install @kjozsa/jenkins-mcp --client claude
手动安装
配置
使用以下 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:
- 默认模式:自动获取并包含带有构建请求的 CSRF 信息
- 使用会话 cookie 来维护网络会话
- 处理幕后的所有 CSRF 保护
- 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