使用说明
Jenkins工业级MCP服务器
一个强大的模型上下文协议（MCP）服务器，将Jenkins CI/CD见解直接带入您的AI驱动开发工具（如Claude Desktop、Cursor和MCP Inspector）。
特性
- 自动化CSRF保护：内置支持为安全生产环境获取和应用Jenkins“Crumb”令牌。
- 深入的工作洞察：用于搜索作业、获取详细配置和列出最近构建历史的工具。
- 日志流：资源处理程序，用于获取任何特定版本的完整控制台日志。
- 安全护栏：触发或停止构建等关键操作需要
confirmed: true旗帜。 - 双重运输：支持两者 工作室 （标准输入/输出）和 上海证券交易所 （基于HTTP的服务器发送事件）。
入门指南（Docker Compose）
测试全栈（Jenkins+MCP Server）最简单的方法是使用Docker Compose。
1.配置凭据
创建一个 .env 根目录中的文件：
JENKINS_URL=http://localhost:8081
JENKINS_USER=admin
JENKINS_TOKEN=your_jenkins_api_token
2.启动堆栈
docker compose up -d --build
- 詹金斯：可在以下网址访问 http://localhost:8081
- MCP服务器：在后台运行为
jenkins-mcp-server
测试和检验
要验证服务器工具和资源，请使用 MCP检查员.
选项A：使用集成堆栈（最快）
如果你的服务器是通过Docker Compose运行的，请“附加”到它：
npx @modelcontextprotocol/inspector -- \
docker exec -i jenkins-mcp-server node build/index.js
选项B：测试独立映像（便携式）
如果你想单独测试构建的映像（模拟IDE如何运行它）：
npx @modelcontextprotocol/inspector -- \
docker run -i --rm --network="host" --env-file .env jenkins-mcp-server
可用工具
list_jobs：发现所有可用的工作。search_jobs：按名称模式筛选作业。get_job_info：获取作业参数、描述和历史记录。list_builds：列出特定作业的最新版本。get_build_status：特定构建的详细结果。trigger_build：开始新的构建（支持参数+安全检查）。stop_build：中止正在运行的构建（进行安全检查）。
可用资源
jenkins://{job}/logs/{id}：获取任何构建的完整纯文本控制台输出。
开发与SSE模式
要使用独立的Jenkins实例在本地运行服务器，请使用 SSE（HTTP） 运输：
# Install dependencies
npm install
# Compile TypeScript
npm run build
# Start in SSE mode
export TRANSPORT=sse
export PORT=3000
npm start
