# deploy-mcp

**Repository Path**: JY1218/deploy-mcp

## Basic Information

- **Project Name**: deploy-mcp
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-29
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Spring AI MCP 自动化部署服务

基于 Spring AI MCP 的通用自动化部署服务,支持多种项目类型的智能检测、构建、部署和实时日志监控。

## 功能特性

- 🔍 **智能项目检测**: 自动识别 Spring Boot、Vue、React、Node.js、Python 项目
- 🔧 **环境检查**: 验证构建工具(Maven、npm、pip 等)是否可用
- 📦 **自动构建**: 根据项目类型选择合适的构建命令
- 🚀 **远程部署**: 通过 SSH 上传并启动应用
- 📋 **实时日志**: 实时回传服务器日志给 AI 分析
- ⏮️ **版本回滚**: 自动备份,支持一键回滚
- 📊 **状态监控**: 实时健康检查和性能监控
- 🌐 **Web 管理界面**: 可视化管理服务器和部署历史

## 技术栈

| 组件 | 技术 | 版本 |
|------|------|------|
| 基础框架 | Spring Boot | 3.2.5 |
| MCP 支持 | Spring AI MCP | 1.1.0-M1 |
| 数据库 | MySQL | 8.0+ |
| ORM | MyBatis-Plus | 3.5.5 |
| SSH 客户端 | JSch | 0.2.18 |
| 前端 | Thymeleaf + Bootstrap | 5.x |

## 快速开始

### 1. 环境准备

```bash
# JDK 21
java -version

# Maven 3.9+
mvn -version

# MySQL 8.0+
mysql --version
```

### 2. 数据库配置

创建数据库:

```sql
CREATE DATABASE IF NOT EXISTS deploy_mcp 
CHARACTER SET utf8mb4 
COLLATE utf8mb4_unicode_ci;
```

修改 `src/main/resources/application.yml` 中的数据库配置:

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/deploy_mcp?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: your_password
```

### 3. 构建和运行

```bash
# 编译项目
mvn clean package -DskipTests

# 运行应用
java -jar target/deploy-mcp-1.0.0.jar
```

### 4. 访问 Web 界面

打开浏览器访问: http://localhost:9090

## MCP 工具列表

| 工具名 | 功能 |
|--------|------|
| list-servers | 列出可用服务器 |
| add-server | 添加服务器配置 |
| detect-project | 检测项目类型 |
| build-project | 构建项目 |
| deploy-project | 部署项目 |
| start-project | 启动项目 |
| upload-script | 上传脚本 |
| server-shell | 执行 Shell 命令 |
| deploy-with-logs | 一站式部署 |
| get-logs | 获取日志 |

## 支持的项目类型

| 项目类型 | 特征文件 | 构建工具 | 部署方式 |
|---------|---------|---------|---------|
| Spring Boot | pom.xml | Maven | JAR 包 |
| Vue.js | package.json + vue | npm/yarn/pnpm | 静态文件 |
| React | package.json + react | npm/yarn/pnpm | 静态文件 |
| Node.js | package.json | npm/yarn/pnpm | Node 应用 |
| Python | requirements.txt | pip/poetry | Python 应用 |

## 许可证

MIT License