MCP Server for Ezone DevOps

MCP (Model Context Protocol) 服务器，用于对接简单云（Ezone）DevOps 平台，为 Cursor、Cherry Studio 等 AI 工具提供接口能力。

📋 功能特性

• ✅ 支持 Streamable HTTP 传输方式
• ✅ 11 个 MCP 工具，覆盖项目管理、代码库、流水线等核心功能
• ✅ 7 个 MCP 提示词，提供场景化的使用指南
• ✅ 14 个 MCP 资源，提供完整的 API 文档查询
• ✅ 完整的 Maven 项目配置
• ✅ 支持多种编程客户端接入

🏗️ 项目结构

mcp-server-devops/
├── pom.xml                                    # Maven 配置
├── README.md                                  # 项目说明文档
├── IFLOW.md                                   # 项目开发文档
├── src/
│   ├── main/
│   │   ├── java/cn/clenarch/mcp/
│   │   │   ├── McpServerApplication.java      # 启动类
│   │   │   ├── client/
│   │   │   │   ├── EzoneApiClient.java        # Ezone API 客户端
│   │   │   │   └── McpClientExample.java      # 客户端调用示例
│   │   │   ├── config/
│   │   │   │   └── EzoneApiConfig.java        # Ezone API 配置类
│   │   │   ├── controller/                    # 控制器
│   │   │   ├── dto/                           # 数据传输对象
│   │   │   │   ├── code/                      # 代码库相关 DTO
│   │   │   │   ├── pipeline/                  # 流水线相关 DTO
│   │   │   │   ├── project/                   # 项目相关 DTO
│   │   │   │   └── registry/                  # 镜像源相关 DTO
│   │   │   ├── prompts/
│   │   │   │   └── DevOpsPrompts.java         # DevOps 提示词工具
│   │   │   ├── resources/
│   │   │   │   └── ApiDocsResource.java       # API 文档资源
│   │   │   └── tools/                         # MCP 工具实现
│   │   │       ├── CodeTools.java             # 代码库管理工具
│   │   │       ├── PipelineTools.java         # 流水线管理工具
│   │   │       ├── ProjectTools.java          # 项目管理工具
│   │   │       └── RegistryTools.java         # 镜像源管理工具
│   │   └── resources/
│   │       └── application.yml                # 应用配置
│   └── test/
│       └── java/cn/clenarch/mcp/tools/
│           ├── PipelineToolsTest.java         # 流水线工具测试
│           └── ProjectToolsTest.java          # 项目工具测试
└── docs-api/                                  # Ezone 接口文档
    └── docs-api-1.0.0/
        ├── ezAdmin.md                         # 后台管理
        ├── ezBpm.md                           # 流程审批
        ├── ezCode.md                          # 代码库管理
        ├── ezDeploy.md                        # 主机部署
        ├── ezDoc.md                           # 文档管理
        ├── ezK8s.md                           # K8S 管理
        ├── ezPackage.md                       # 制品库管理
        ├── ezPipeline.md                      # 流水线管理
        ├── ezProject.md                       # 项目管理
        ├── ezResource-Manager.md              # 服务集成
        ├── ezScan.md                          # 代码扫描
        └── ezTest.md                          # 测试管理

📥 下载和安装

客户使用（推荐）

客户无需自己编译，直接下载发布包即可。

方式1：Docker 部署（推荐）

# 下载发布包
wget https://github.com/li7hai26/mcp-server-devops/releases/download/v1.0.0/mcp-server-devops-1.0.0-docker.tar.gz

# 解压
tar -xzf mcp-server-devops-1.0.0-docker.tar.gz
cd docker-release

# 启动服务
./start.sh

# 查看日志
docker logs -f mcp-server-devops

# 停止服务
./stop.sh

方式2：直接拉取镜像

# 拉取镜像
docker pull cleanarch/mcp-server-devops:1.0.0

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

方式3：二进制部署（备用）

# 下载发布包
wget https://github.com/li7hai26/mcp-server-devops/releases/download/v1.0.0/mcp-server-devops-1.0.0-binary.tar.gz

# 解压
tar -xzf mcp-server-devops-1.0.0-binary.tar.gz
cd mcp-server-devops-1.0.0-binary

# 启动服务
./scripts/start-binary.sh

# 查看日志
tail -f logs/mcp-server.log

# 停止服务
./scripts/stop-binary.sh

开发者使用

开发者需要克隆代码库并进行本地开发。

# 克隆代码库
git clone https://github.com/li7hai26/mcp-server-devops.git
cd mcp-server-devops

# 构建项目
./scripts/build/build-dev.sh

# 启动服务
./scripts/start/start-dev.sh

🚀 快速开始

1. 环境要求

• JDK 17+
• Maven 3.6+

2. 配置 Ezone API（可选）

注意: Ezone API 认证信息现在通过 MCP 客户端传递，无需在服务器端配置。

方式 1: 环境变量（默认值，可选）

export EZONE_BASE_URL=https://srih.ezone.work
export EZONE_ACCESS_TOKEN=default_token
export EZONE_COMPANY_NAME=default
export EZO

... [View full README on GitHub](https://github.com/li7hai26/mcp-server-devops#readme)