返回 MCP 目录
public公开dns本地运行

jenkins-mcp-server

一个为大型语言模型提供标准化接口的Jenkins MCP服务器,支持访问Jenkins数据和执行相关操作。

article

README

🚀 Jenkins MCP 服务器

Jenkins MCP 服务器是一个模型上下文协议(MCP)服务器,它提供对 Jenkins 数据和功能的访问。通过标准化接口,该服务器能为大型语言模型(LLMs)提供服务,助力其更好地与 Jenkins 进行交互。

🚀 快速开始

Jenkins MCP 服务器实现了一个 MCP 服务器,并连接到 Jenkins 实例,使得大型语言模型能够:

  • 访问 Jenkins 工作数据作为资源。
  • 通过工具执行与 Jenkins 相关的操作。
  • 利用预定义提示进行常见 Jenkins 交互。

📦 安装指南

先决条件

  • Python 3.8+
  • 对 Jenkins 实例的访问权限

使用 uv 设置环境

我们推荐使用 uv 管理 Python 环境:

# 如果尚未安装 uv,请运行以下命令进行安装
curl -sSf https://install.ultraviolet.dev | sh

# 创建新项目
uv init jenkins-mcp-server
cd jenkins-mcp-server

# 添加依赖项
uv add "mcp[cli]"
uv add python-jenkins

环境变量

创建一个 .env 文件,输入您的 Jenkins 配置信息:

# 创建 .env 文件
cat > .env << EOL
JENKINS_URL=https://your-jenkins-instance.com
JENKINS_USERNAME=your_username
JENKINS_API_TOKEN=your_api_token
EOL

# 在 shell 中加载环境变量
source .env

💻 使用示例

基础用法

使用开发模式启动服务器:

uv run mcp dev server.py

✨ 主要特性

  • 资源:访问 Jenkins 作业配置、构建历史和状态信息。
  • 工具:触发构建、更新作业配置并管理 Jenkins 任务。
  • 提示:用于常见 Jenkins 操作的预定义交互模式。

🤝 项目贡献

欢迎贡献!请随时提交 Pull Request。

📄 许可证

该项目在 MIT 许可证下,详情请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端