Host MCP Jenkins

主持人mcp詹金斯

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

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

为什么？

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

兼容性

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

插件依赖关系

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

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

API端点矩阵

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

快速开始

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启动服务器，请执行以下操作：

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优先）：

获取Jenkins API令牌

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

MCP客户端配置

克劳德桌面

添加到您的 claude_desktop_config.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:

{
  "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服务器配置中：

{
  "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代码/光标：

{
  "mcpServers": {
    "jenkins": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Docker使用

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

在主机上运行MCP服务器

在主机上使用HTTP传输启动服务器：

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编写示例

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）

构建日志（3）

供应链管理（4）

测试结果（2）

与Jenkins MCP服务器插件的比较

发展

# 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

许可证

麻省理工学院