Jenkins Server MCP

by hekmon8

Integrations

  • Provides tools for interacting with Jenkins CI/CD servers, allowing users to check build statuses, trigger builds with parameters, and retrieve build logs from Jenkins jobs.

  • Connects to TP-Link's Jenkins server (sohoci.rd.tp-link.net/jenkins) by default, enabling interaction with TP-Link's continuous integration environment.

Jenkins 服务器 MCP

模型上下文协议 (MCP) 服务器提供与 Jenkins CI/CD 服务器交互的工具。该服务器使 AI 助手能够通过标准化接口检查构建状态、触发构建以及检索构建日志。

安装

  1. 克隆此存储库:
git clone https://github.com/yourusername/jenkins-server-mcp.git cd jenkins-server-mcp
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build

配置

服务器需要以下环境变量:

  • JENKINS_URL :你的 Jenkins 服务器的 URL(默认为“ http://sohoci.rd.tp-link.net/jenkins ”)
  • JENKINS_USER :用于身份验证的 Jenkins 用户名
  • JENKINS_TOKEN :用于身份验证的 Jenkins API 令牌

在您的 MCP 设置文件中配置这些:

对于克劳德桌面

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "jenkins-server": { "command": "node", "args": ["/path/to/jenkins-server-mcp/build/index.js"], "env": { "JENKINS_URL": "https://your-jenkins-server.com", "JENKINS_USER": "your-username", "JENKINS_TOKEN": "your-api-token" } } } }

工具和用法

1. 获取构建状态

获取 Jenkins 构建的状态:

// Example usage const result = await mcpClient.useTool("jenkins-server", "get_build_status", { jobPath: "view/xxx_debug", buildNumber: "lastBuild" // Optional, defaults to lastBuild });

输入模式:

{ "jobPath": "string", // Path to Jenkins job "buildNumber": "string" // Optional, build number or "lastBuild" }

2. 触发构建

使用参数触发新的 Jenkins 构建:

// Example usage const result = await mcpClient.useTool("jenkins-server", "trigger_build", { jobPath: "view/xxx_debug", parameters: { BRANCH: "main", BUILD_TYPE: "debug" } });

输入模式:

{ "jobPath": "string", // Path to Jenkins job "parameters": { // Build parameters as key-value pairs } }

3. 获取构建日志

检索 Jenkins 构建的控制台输出:

// Example usage const result = await mcpClient.useTool("jenkins-server", "get_build_log", { jobPath: "view/xxx_debug", buildNumber: "lastBuild" });

输入模式:

{ "jobPath": "string", // Path to Jenkins job "buildNumber": "string" // Build number or "lastBuild" }

发展

对于使用自动重建的开发:

npm run watch

调试

由于 MCP 服务器通过 stdio 进行通信,因此您可以使用 MCP Inspector 进行调试:

npm run inspector

这将提供一个 URL 来访问浏览器中的调试工具。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

模型上下文协议服务器使 AI 助手能够与 Jenkins CI/CD 服务器交互,提供检查构建状态、触发构建和检索构建日志的工具。

  1. Installation
    1. Configuration
      1. For Claude Desktop
    2. Tools and Usage
      1. 1. Get Build Status
      2. 2. Trigger Build
      3. 3. Get Build Log
    3. Development
      1. Debugging
    4. License
      ID: a7wprn7goz