Jenkins MCP Enterprise

Jenkins MCP服务器企业版

Jenkins MCP服务器，用于多实例路由、构建诊断和可选的向量搜索。

Jenkins的模型上下文协议（MCP）服务器，提供构建管理、日志检查、故障诊断和多实例配置。此存储库中维护的安装路径是源代码安装和Docker/Compose。

它做什么

• 触发器同步或异步构建
• 在触发或检查工作之前找到工作
• 检查作业定义和来源位置
• 检索日志并运行目标日志搜索工具
• 发现下游和子构建层次结构
• 检查最近的版本或特定版本的窗口
• 使用可配置的建议诊断构建失败
• 根据以下内容将每个工具调用路由到正确的Jenkins实例 jenkins_url
• 暴露 semantic_search 仅当启用矢量搜索时
• 暴露 apply_job_edit 仅当启用服务器端作业编辑时

快速开始

先决条件

• Python 3.10+
• Jenkins API访问
• Jenkins用户名和API令牌
• 如果你想部署容器，可以使用Docker和Docker Compose
• Qdrant如果你愿意 semantic_search

从源代码安装

git clone https://github.com/Jordan-Jarvis/jenkins-mcp-enterprise
cd jenkins-mcp-enterprise
python3 -m pip install -e .

了解两个配置层

服务器使用两个配置层：

• 主服务器配置： config/mcp-config.yml
• 诊断配置：从以下位置之一加载：

- --diagnostic-config /path/to/file.yml - JENKINS_MCP_DIAGNOSTIC_CONFIG=/path/to/file.yml - config/diagnostic-parameters.yml - 捆绑默认值 jenkins_mcp_enterprise/diagnostic_config/diagnostic-parameters.yml

您始终需要主服务器配置。如果你想覆盖捆绑的诊断默认值，你只需要一个项目本地诊断配置文件。

创建主服务器配置

mkdir -p config
cp config/mcp-config.example.yml config/mcp-config.yml

编辑 config/mcp-config.yml 使用您的Jenkins URL和凭据。

如果你想为非SCM支持的作业设置可选的Jenkins管理的作业编辑工作流，还可以设置：

settings:
  enable_job_editing: true
  job_edit_workspace_dir: "/tmp/mcp-jenkins/job-definitions"

可选项目本地诊断覆盖

仅当您想调整时才创建此项 diagnose_build_failure:

cat > config/diagnostic-parameters.yml << 'ENDDIAG'
semantic_search:
  min_diagnostic_score: 0.65
  max_total_highlights: 4

recommendations:
  max_recommendations: 5
ENDDIAG

如果要进行语义搜索，请启动本地向量堆栈并设置 disable_vector_search: false 和 vector.host: "http://localhost:6333":

./scripts/start_dev_environment.sh

Docker和Compose

cp config/mcp-config.example.yml config/mcp-config.yml
./start-jenkins_mcp_enterprise.sh

看 用于容器部署流程。

启动服务器

jenkins_mcp_enterprise --config config/mcp-config.yml

连接到克劳德桌面

添加 ~/.claude_desktop_config.json:

{
  "mcpServers": {
    "jenkins": {
      "command": "jenkins_mcp_enterprise",
      "args": ["--config", "config/mcp-config.yml"]
    }
  }
}

使用说明

• 当工具或提示依赖于以下内容时，传递完整的Jenkins构建URL jenkins_url.
• 在多Jenkins设置中，每个工具调用从以下位置解析一个已配置的实例 jenkins_url服务器不会在一次调用中遍历所有配置的Jenkins实例。
• semantic_search 仅在启用矢量搜索时可用。
• apply_job_edit 仅在以下情况下可用 settings.enable_job_editing: true.
• get_job_definition 返回SCM支持的管道的SCM位置详细信息。对于内联管道，它会暂存一个本地Groovy文件进行补丁/编辑/上传。对于其他Jenkins管理的作业，它分阶段 config.xml.
• diagnose_build_failure 始终使用诊断配置层。如果不提供项目本地覆盖，则使用捆绑的默认值。
• Docker镜像包括 ripgrep，所以 ripgrep_search 和 navigate_log 在容器部署中工作。

常见使用模式

Analyze this failed build: https://jenkins.company.com/job/api-service/456/
Find the root cause in this nested pipeline: https://jenkins.company.com/job/monorepo/job/main/789/
Show me the test failure section from this build: https://jenkins.company.com/job/tests/321/
Find similar authentication failures in recent builds

可用工具

配置文档

• 配置指南
• 诊断配置概述
• 诊断参数指南
• 诊断参数快速参考

发展

# Start local supporting services when vector search is enabled
./scripts/start_dev_environment.sh

# Run tests
python3 -m pytest tests/ -v

# Format code
python3 -m black .

许可证

GPL v3