Host MCP Jenkins

MCP运维云端

提供方 mister-good-deal · 包名 @mister-good-deal/host-mcp-jenkins

运维云端 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

一个本地运行的Jenkins MCP服务代理,无需安装插件即可通过Jenkins REST API提供17种管理工具,适用于无管理员权限的场景。

一句话选型结论

按资料字段整理

Host MCP Jenkins 属于运维云端类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 17 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量17暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

CI/CD工具TypeScript本地部署Jenkins集成API代理无插件管理开发运维

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx @mister-good-deal/host-mcp-jenkins \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 17 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 17 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Host MCP Jenkins当前 17 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mister-good-deal上游标注的维护方 mister-good-deal
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@mister-good-deal/host-mcp-jenkins · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.1 KB
来自项目仓库与上游目录的原文,未做删改

主持人mcp詹金斯

Jenkins的本地MCP(模型上下文协议)服务器,用于复制 Jenkins MCP服务器插件 通过HTTP调用Jenkins REST API。

Jenkins实例上不需要安装插件。

为什么?

Jenkins服务器上必须安装官方的Jenkins MCP服务器插件。如果您没有安装插件的管理员权限, host-mcp-jenkins 为您提供了在本地运行的17个相同的MCP工具,使用您的个人API令牌调用Jenkins REST API。

兼容性

Jenkins版本 · 状态
LTS 2.462.x+ · ✅ 完全支持
LTS 2.426.x✅ 完全支持
LTS 2.401.x✅ 完全支持
LTS 2.361.x✅ 完全支持
每周(最新) · ✅ 完全支持

> 最低版本: 詹金斯2.164+。自最早的2.x版本以来,该服务器使用的所有REST API端点都可以在Jenkins核心中使用。这 tree Jenkins 1.464中引入了查询参数(用于响应字段过滤)。

插件依赖关系

大多数工具(17个工具中有11个)只使用Jenkins核心REST API,不需要任何插件。一些工具类别取决于特定的插件:

工具 必需插件 最小插件版本 注释
getJobScm, getBuildScm, findJobsWithScmUrl Git插件 2.0+ 通过Git插件操作暴露SCM数据
getTestResults JUnit插件 1.0+ 自1.577以来与Jenkins捆绑在一起
getFlakyFailures JUnit插件 1.33+ 需要缺陷检测支持

> 注: Git插件安装在约96%的Jenkins控制器上。JUnit插件的安装率约为97%,自1.577版本以来,默认情况下已与Jenkins捆绑在一起。如果这些插件不存在,相应的工具将返回空结果或404错误。

API端点矩阵

每个工具都映射到一个或多个Jenkins REST API端点。所有JSON端点都支持 tree 字段过滤参数。

工具 · 方法 · REST端点 · 依赖关系
getJob · 得到 · /job/{name}/api/json · 核心
getJobs · 得到 · /api/json · 核心
getBuild · 得到 · /job/{name}/{build\ · lastBuild}/api/json · 核心
triggerBuild · 职位 · /job/{name}/build, /job/{name}/buildWithParameters · 核心
updateBuild · 职位 · /job/{name}/{build}/submitDescription, configSubmit · 核心
whoAmI · 得到 · /me/api/json · 核心
getStatus · 得到 · /api/json, /computer/api/json, /queue/api/json · 核心
getQueueItem · 得到 · /queue/item/{id}/api/json · 核心
getBuildLog · 得到 · /job/{name}/{build}/consoleText · 核心
getProgressiveBuildLog · 得到 · /job/{name}/{build}/logText/progressiveText · 核心
searchBuildLog · 得到 · /job/{name}/{build}/consoleText · 核心
getJobScm · 得到 · /job/{name}/api/json · Git插件
getBuildScm · 得到 · /job/{name}/{build}/api/json · Git插件
getBuildChangeSets · 得到 · /job/{name}/{build}/api/json · 核心
findJobsWithScmUrl · 得到 · /api/json (递归三级树) · Git插件
getTestResults · 得到 · /job/{name}/{build}/testReport/api/json · JUnit插件
getFlakyFailures · 得到 · /job/{name}/{build}/testReport/api/json · JUnit插件≥1.33

快速开始```bash

npx @mister-good-deal/host-mcp-jenkins \
--jenkins-url https://jenkins.example.com \
--jenkins-user your-username \
--jenkins-token your-api-token


### HTTP传输

要使用Streamable HTTP传输而不是stdio启动服务器,请执行以下操作:```bash
npx @mister-good-deal/host-mcp-jenkins \
--jenkins-url https://jenkins.example.com \
--jenkins-user your-username \
--jenkins-token your-api-token \
--transport http \
--port 3000

这暴露了:

  • 健康检查: GET /health → {"status":"ok"}
  • MCP端点: /mcp (流式HTTP)
  • 平滑关闭 上 SIGINT / SIGTERM

配置

所有选项都支持CLI参数和环境变量(CLI优先):

CLI参数 · 环境变量 · 必需 · 默认值 · 描述
--jenkins-url · JENKINS_URL · ✅ · — · Jenkins基本URL
--jenkins-user · JENKINS_USER · ✅ · — · Jenkins用户名
--jenkins-token · JENKINS_API_TOKEN · ✅ · — · Jenkins API令牌
--insecure · JENKINS_INSECURE=true · false · 跳过TLS证书验证
--log-level · LOG_LEVEL · info · debug · info · warn · error
--timeout · JENKINS_TIMEOUT · 30000 · HTTP请求超时(毫秒)
--max-retries · JENKINS_MAX_RETRIES · 3 · 瞬时错误的最大重试次数(429/5xx)
--retry-delay · JENKINS_RETRY_DELAY · 1000 · 指数退避的基延迟(毫秒)
--transport · MCP_TRANSPORT · stdio · 运输类型(stdio · http)
--port · MCP_PORT · 3000 · HTTP服务器端口(仅限 --transport http)

获取Jenkins API令牌

  1. 登录Jenkins
  2. 点击您的用户名(右上角)→ 配置
  3. 在...之下 API代币,单击 添加新令牌
  4. 命名并单击 生成 --复制令牌值

MCP客户端配置

克劳德桌面

添加到您的 claude_desktop_config.json:```json
{
"mcpServers": {
"jenkins": {
"command": "npx",
"args": ["-y", "@mister-good-deal/host-mcp-jenkins"],
"env": {
"JENKINS_URL": "https://jenkins.example.com",
"JENKINS_USER": "your-username",
"JENKINS_API_TOKEN": "your-api-token"
}
}
}
}


### VS代码

增添 `.vscode/mcp.json`:```json
{
"servers": {
"jenkins": {
"command": "npx",
"args": ["-y", "@mister-good-deal/host-mcp-jenkins"],
"env": {
"JENKINS_URL": "https://jenkins.example.com",
"JENKINS_USER": "your-username",
"JENKINS_API_TOKEN": "your-api-token"
}
}
}
}

光标

添加到MCP服务器配置中:```json
{
"mcpServers": {
"jenkins": {
"command": "npx",
"args": ["-y", "@mister-good-deal/host-mcp-jenkins", "--jenkins-url", "https://jenkins.example.com", "--jenkins-user", "your-username", "--jenkins-token", "your-api-token"]
}
}
}


> **贡献者须知:** 如果您在此工作区内运行MCP服务器(其中 `package.json` 宣布 `"packageManager": "pnpm@..."`)以及 `npx` 失败与 `host-mcp-jenkins: not found`,使用 `pnpm dlx` 相反。这是因为corepack拦截 `npx` 从pnpm管理的项目运行时。

### HTTP传输(远程)

当服务器运行时 `--transport http`,MCP客户端可以通过HTTP URL连接,而无需启动子进程:

**克劳德桌面/VS代码/光标:**```json
{
"mcpServers": {
"jenkins": {
"url": "http://localhost:3000/mcp"
}
}
}

Docker使用

HTTP传输使运行在Docker容器内的AI代理能够连接到MCP服务器,而不需要MCP网关。

在主机上运行MCP服务器

在主机上使用HTTP传输启动服务器:```bash
npx @mister-good-deal/host-mcp-jenkins \
--jenkins-url https://jenkins.example.com \
--jenkins-user your-username \
--jenkins-token your-api-token \
--transport http \
--port 3000


从Docker容器内部,连接到 `http://host.docker.internal:3000/mcp`.

### Docker编写示例```yaml
services:
ai-agent:
image: your-ai-agent:latest
environment:
MCP_SERVER_URL: "http://host.docker.internal:3000/mcp"
extra_hosts:
- "host.docker.internal:host-gateway"

> 注: 这 extra_hosts 在Linux上需要映射。在macOS和Windows上,Docker桌面解决了 host.docker.internal 自动。

可用工具(17)

与完全对等 Jenkins MCP服务器插件,加上额外功能:

核心(8)

工具 说明
getJob 按完整路径获得Jenkins工作
getJobs 获取按名称排序的Jenkins作业分页列表
getBuild 获取Jenkins作业的特定版本或最后一个版本
triggerBuild 触发Jenkins作业的构建(支持参数)
updateBuild 更新构建显示名称和/或描述
whoAmI 获取当前已验证用户的信息
getStatus 检查Jenkins实例的运行状况和准备状态
getQueueItem 通过其ID获取队列项目详细信息

构建日志(3)

工具 说明
getBuildLog 检索构建的分页日志行
getProgressiveBuildLog 通过Jenkins渐进文本API增量检索构建日志
searchBuildLog 搜索与模式(字符串或正则表达式)匹配的日志行

供应链管理(4)

工具 说明
getJobScm 检索Jenkins作业的SCM配置
getBuildScm 检索Jenkins构建的SCM配置
getBuildChangeSets 检索Jenkins构建的更改日志集
findJobsWithScmUrl 查找使用指定git SCM URL的作业

测试结果(2)

工具 说明
getTestResults 检索构建的测试结果(可选仅失败)
getFlakyFailures 检索构建的片状测试失败

与Jenkins MCP服务器插件的比较

功能 Jenkins插件 主机mcp Jenkins
安装 需要Jenkins管理员 无-在本地运行
传输 SSE、可流式HTTP、无状态 stdio(默认)、可流化HTTP
身份验证 Jenkins内置 基于HTTP Basic的API令牌
工具 16 17(完全奇偶校验+渐进日志)
响应格式 ToolResponse 信封 相同 ToolResponse 信封
tree 参数 通过内部API 转发到REST API

发展```bash

Install dependencies

pnpm install

Build

pnpm run build

Run in development mode

pnpm run dev -- --jenkins-url https://jenkins.example.com --jenkins-user admin --jenkins-token TOKEN

Lint

pnpm run lint

Unit tests

pnpm test

Integration tests (requires Docker)

pnpm run test:integration
```

许可证

麻省理工学院

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Host MCP Jenkins 怎么安装?

在客户端按下面的安装命令接入:npx @mister-good-deal/host-mcp-jenkins \。对应的包名是 @mister-good-deal/host-mcp-jenkins。装完在客户端配置里引用同一个包或端点。

Host MCP Jenkins 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Host MCP Jenkins 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Host MCP Jenkins 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Host MCP Jenkins 能提供哪些能力?

资料显示约 17 个工具;能力标签包括 TypeScript、API代理、云端部署。具体工具清单以官方文档为准。

Host MCP Jenkins 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Host MCP Jenkins 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。