星战科技xingzhan.cloud
返回市场
詹金斯-MCP-企业版

詹金斯-MCP-企业版

作者：Jordan-Jarvis9 星标更新：2025-10-29
安装使用来源：spider==github.com

项目介绍

🚀 Jenkins MCP Server Enterprise

最先进的Jenkins MCP服务器 - 针对企业级调试、多实例管理和人工智能驱动的故障分析而设计。

这是一个生产就绪的模型上下文协议（MCP）服务器，它改变了AI助手与Jenkins交互的方式。与基本的Jenkins集成不同，该服务器提供了企业级调试能力、智能故障分析以及前所未有的流水线可见性。

🌟 为什么选择这个Jenkins MCP服务器？

🔥 卓越的构建失败调试

  • 人工智能诊断：高级故障分析真正理解您的构建错误
  • 分层子构建发现：无限深度导航复杂的流水线结构
  • 大量日志处理：高效处理10+GB的日志，采用流式传输和智能分块
  • 智能错误模式识别：使用正则表达式捕获组配置规则以实现自动化数据提取
  • 动态消息生成：从构建日志中自动提取特定的错误代码、版本和时间戳

🏢 企业级多Jenkins支持

  • 负载均衡路由：跨多个Jenkins服务器自动选择实例
  • 集中管理：单个MCP服务器管理数十个Jenkins实例
  • 实例健康监控：自动故障转移和健康检查
  • 灵活的身份验证：每个实例的凭据和SSL配置

🧠 可配置的人工智能诊断

  • 组织特定调整：根据您的技术堆栈定制诊断行为
  • 高级模式匹配：带有动态消息模板的正则表达式捕获组
  • 基于关键词的指令：LLM根据构建失败模式接收定制指导
  • 语义搜索：向量驱动的日志分析在海量日志中找到相关上下文
  • 自定义推荐引擎：通过插值提取的数据生成可操作见解

⚡ 性能与扩展性

  • 并行处理：复杂流水线层次结构的同时分析
  • 智能缓存：压缩和保留策略的智能日志存储
  • 向量搜索引擎：通过历史构建数据进行闪电般的语义搜索
  • HTTP流传输：现代传输，使用服务端发送事件实现实时更新

🎯 适用于

  • DevOps团队处理复杂的CI/CD流水线
  • 运行多个Jenkins实例的组织
  • 需要深入构建失败分析的工程师
  • 希望AI助手真正理解其Jenkins设置的团队

🚀 快速开始

📋 先决条件

  • Python 3.10+（现代Python特性）
  • Docker及Docker Compose（生产部署）
  • Jenkins API访问（任何版本，带Pipeline插件）
  • Jenkins API令牌（从用户配置文件生成）

⚡ 60秒设置

选项1：从PyPI安装（推荐）

# 1. 安装包
pip install jenkins_mcp_enterprise

# 2. 创建配置文件
mkdir -p config
cp config/mcp-config.example.yml config/mcp-config.yml

选项2：从源码安装

# 1. 克隆并安装
git clone https://github.com/Jordan-Jarvis/jenkins-mcp-enterprise
cd jenkins-mcp
python3 -m pip install -e .

# 2. 启动向量搜索引擎（推荐）
./scripts/start_dev_environment.sh

# 3. 配置您的Jenkins实例
cat > config/mcp-config.yml << 'EOF'
jenkins_instances:
  production:
    url: "https://jenkins.yourcompany.com"
    username: "your.email@company.com"
    token: "your-api-token"
    display_name: "生产Jenkins"

vector:
  disable_vector_search: false  # 启用AI驱动的搜索
  host: "http://localhost:6333"

settings:
  fallback_instance: "production"
EOF

# 4. 启动服务器
jenkins_mcp_enterprise --config config/mcp-config.yml

🎯 连接到Claude桌面

添加到~/.claude_desktop_config.json：

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

就这样！ 您的AI助手现在具有企业级Jenkins功能。

💬 基本使用指南

一旦连接到您的AI助手（如Claude等），您可以立即开始诊断构建失败：

🎯 简单的构建诊断

你好，你能帮我诊断为什么这个构建失败了吗？
https://jenkins.company.com/job/MyApp/job/feature-branch/123/

⚠️ 重要提示：始终提供完整的Jenkins URL，包括：

  • 完整主机名（启用多Jenkins路由）
  • 完整的工作路径，包括文件夹
  • 构建编号

🔍 常见使用模式

# 基本故障分析
"你能分析这个失败的构建吗？https://jenkins.company.com/job/api-service/456/"

# 深入子构建调查
"这个流水线有嵌套失败，你能找到根本原因吗？https://jenkins.company.com/job/monorepo/job/main/789/"

# 查找类似问题
"查找最近构建中的类似身份验证失败"

# 获取特定日志部分
"显示这个构建中第2000-2500行的测试失败日志：https://jenkins.company.com/job/tests/321/"

🌐 多Jenkins支持

服务器会根据URL自动路由请求：

# 生产Jenkins
"分析：https://jenkins-prod.company.com/job/deploy/456/"

# 开发Jenkins
"调试：https://jenkins-dev.company.com/job/feature/123/"

# 欧洲Jenkins实例
"检查：https://jenkins-eu.company.com/job/service/789/"

🔄 URL解析：MCP服务器将URL与您配置的Jenkins实例匹配，并自动使用适当的凭据。

📊 您将获得什么

  • 故障分析：人工智能驱动的根本原因识别
  • 子构建层次结构：导航复杂的流水线结构
  • 智能建议：基于您的技术堆栈的操作修复
  • 相关日志部分：突出显示关键故障点
  • 相似问题搜索：在构建历史中查找模式

🛠️ 高级功能

🔍 人工智能驱动的构建诊断

diagnose_build_failure工具是调试游戏规则改变者：

# 其他工具提供的内容：
"构建失败。检查日志。"

# 此服务器提供的内容：
{
  "failure_analysis": "构建-app模块中的Maven依赖冲突",
  "root_cause": "Spring Boot版本之间的版本不匹配",
  "affected_subbuilds": ["构建-app #145", "集成测试 #89"],
  "recommendations": [
    "🔧 在build-app/pom.xml中更新Spring Boot版本至2.7.8",
    "📋 运行dependency:tree以验证兼容性",
    "🧪 使用./scripts/test-build-integration.sh进行测试"
  ],
  "relevant_logs": "第2847-2893行：NoSuchMethodError: spring.boot.context",
  "hierarchy_guidance": "关注构建-app #145 - 最深的故障点"
}

🏢 多Jenkins企业设置

轻松管理复杂的环境：

jenkins_instances:
  us-east-prod:
    url: "https://jenkins-us-east.company.com"
    username: "service-account@company.com"
    token: "your-api-token-here"
    description: "美国东部生产环境"
    
  eu-west-prod:
    url: "https://jenkins-eu-west.company.com"
    username: "service-account@company.com"
    token: "your-api-token-here"
    description: "欧洲西部生产环境"
    
  development:
    url: "https://jenkins-dev.company.com"
    username: "dev-user@company.com"
    token: "your-api-token-here"
    description: "开发环境"

settings:
  fallback_instance: "us-east-prod"
  enable_health_checks: true
  health_check_interval: 300

🧠 可配置的人工智能诊断

诊断引擎完全可定制，以理解您的特定技术堆栈和组织模式：

📋 快速参考：诊断参数快速指南 📚 完整文档：诊断参数指南

# config/diagnostic-parameters.yml - 用户覆盖文件（自动检测）
semantic_search:
  search_queries:
    - "spring boot依赖冲突"
    - "Kubernetes部署失败"
    - "Terraform计划错误"
    - "构建认证失败"
  min_diagnostic_score: 0.6

recommendations:
  patterns:
    spring_boot_conflict:
      conditions: ["spring", "dependency", "conflict"]
      message: "🔧 检测到Spring Boot冲突。运行'mvn dependency:tree'并检查版本不匹配。"
    
    k8s_deployment_failure:
      conditions: ["kubernetes", "deployment", "failed"]
      message: "☸️ Kubernetes部署问题。检查资源限制和网络策略。"

build_processing:
  parallel:
    max_workers: 8        # 高性能：8，资源受限：2
    max_batch_size: 10    # 并发构建处理数量
  
context:
  max_tokens_total: 20000 # 分析内存预算

🎯 常见配置：

  • 高性能：max_workers: 8, max_tokens_total: 20000
  • 资源受限：max_workers: 2, max_tokens_total: 3000
  • 详细分析：max_total_highlights: 10, max_recommendations: 10

⚡ 向量驱动的搜索

在所有构建历史中进行闪电般快速的语义搜索：

# 在所有构建中查找类似的失败
semantic_search "认证超时构建"

# 结果包括几周前具有类似问题的构建
# 根据相关性排名，而不仅仅是关键字匹配

🔧 可用工具（共10个）

🤖 AI及诊断工具

工具目的独特功能
diagnose_build_failureAI故障分析子构建层次结构，语义搜索，自定义建议
semantic_search向量驱动的搜索跨构建模式识别，相关性排名

🚀 构建管理工具

工具目的独特功能
trigger_build同步构建触发等待完成，参数验证
trigger_build_async异步构建触发非阻塞执行，并行构建
trigger_build_with_subs子构建监控实时状态跟踪，层次结构发现
get_jenkins_job_parameters作业参数发现多实例支持，参数详情

🔍 日志分析及搜索工具

工具目的独特功能
ripgrep_search高速正则表达式搜索上下文窗口，大量文件处理
filter_errors_grep智能错误过滤预设模式，相关性评分
navigate_log智能日志导航部分跳转，发生次数跟踪
get_log_context目标日志提取行范围，智能分块

🏗️ 架构亮点

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   AI助手     │────│  Jenkins MCP Pro │────│ 多Jenkins基础设施  │
│   (Claude等)  │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                    ┌─────────┼─────────┐
                    │         │         │
                ┌───▼───┐ ┌───▼───┐ ┌───▼────┐
                │向量   │ │缓存   │ │诊断引擎│
                │搜索引擎│ │管理器 │ │        │
                │       │ │       │ │        │
                └───────┘ └───────┘ └────────┘

🚀 关键架构优势：

  • 依赖注入：干净、可测试、易于维护的代码
  • 流式架构：处理大量日志而不出现内存问题
  • 并行处理：并发子构建分析
  • 模块化设计：易于扩展和定制
  • 生产就绪：经过实战考验，具备完善的错误处理机制

📊 生产部署

🐳 Docker Compose（推荐）

# 1. 配置您的Jenkins实例
cp config/mcp-config.example.yml config/mcp-config.yml
vim config/mcp-config.yml  # 添加您的Jenkins URL和令牌

# 2. 复制Docker模板并配置
cp .env.example .env

# 3. 部署全栈
docker-compose up -d

# 4. 验证部署
docker-compose ps
curl http://localhost:8000/health

⚙️ 配置管理

所有配置均通过YAML文件处理 - 不需要环境变量：

# 创建您的配置文件
cp config/mcp-config.example.yml config/mcp-config.yml

# 使用配置启动
python3 -m jenkins_mcp_enterprise.server --config config/mcp-config.yml

# 自定义诊断参数（可选）
cp jenkins_mcp_enterprise/diagnostic_config/diagnostic-parameters.yml config/diagnostic-parameters.yml
# 根据需要编辑config/diagnostic-parameters.yml

🔐 安全特性

  • 每实例身份验证：每个Jenkins实例的独立凭据
  • SSL验证：可配置证书验证
  • 基于令牌的访问：安全的API令牌身份验证
  • 网络隔离：Docker网络安全
  • 凭据管理：支持YAML配置文件

📈 性能基准

指标本服务器基础替代方案
大型日志处理10GB约30秒经常失败或超时
子构建发现50+嵌套层级通常1-2层级
多实例管理无限制实例单实例
诊断质量人工智能驱动的洞察基本错误模式
搜索性能向量搜索<1秒grep搜索10秒+

🎓 学习资源

📚 文档

🧪 示例

# 使用自定义配置测试诊断引擎
python3 -m jenkins_mcp_enterprise.server --config config/mcp-config.yml

# 验证您的配置语法
python3 -c "import yaml; yaml.safe_load(open('config/mcp-config.yml'))"

# 测试诊断参数
python3 -c "from jenkins_mcp_enterprise.diagnostic_config import get_diagnostic_config; get_diagnostic_config()"

🤝 贡献

我们欢迎贡献！此项目使用：

  • 现代Python（3.10+）带类型提示
  • Black代码格式化（无linting冲突）
  • 全面测试使用pytest
  • Docker用于一致的开发
# 开发设置
git clone https://github.com/Jordan-Jarvis/jenkins-mcp-enterprise
cd jenkins-mcp
python3 -m pip install -e .
./scripts/start_dev_environment.sh

# 运行测试
python3 -m pytest tests/ -v

# 格式化代码
python3 -m black .

☕ 支持该项目

如果这个Jenkins MCP服务器为您节省了调试构建失败的时间，或者使您的CI/CD工作流程更有效率，请考虑支持其开发：

<div align="center">

请我喝杯咖啡

每一杯咖啡都帮助推动更多功能和改进！ ☕️

</div>

您的支持有助于维持此项目并开发新功能，例如：

  • 🔍 增强的AI诊断能力
  • 🚀 额外的Jenkins集成
  • 📊 高级分析和报告
  • 🛠️ 新的MCP工具和工作流程

📝 许可证

GPL v3许可证 - 使用Jenkins和AI构建令人惊叹的事物！

<div align="center">

🚀 今天就改变您的Jenkins调试体验吧！

⭐ 关注此仓库 • 📖 阅读文档 • 🐛 报告问题 • 💬 参与讨论 • ☕ 请我喝杯咖啡

为要求更多的CI/CD工具的DevOps团队而打造

</div>