# devil-ai

**Repository Path**: deviling/devil-ai

## Basic Information

- **Project Name**: devil-ai
- **Description**: Spring Ai X MCP 实现AI 操作业务数据
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-04-12
- **Last Updated**: 2025-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Devil-AI

<p align="center">
  <a href="https://gitee.com/deviling/devil-ai">
    <img src="https://gitee.com/deviling/devil-ai/badge/star.svg?theme=dark" alt="Gitee star">
  </a>
  <a href="https://gitee.com/deviling/devil-ai">
    <img src="https://gitee.com/deviling/devil-ai/badge/fork.svg?theme=dark" alt="Gitee fork">
  </a>
  <a href="https://gitee.com/deviling/devil-ai">
    <img src="https://img.shields.io/badge/JDK-17-blue.svg" alt="JDK 17">
  </a>
  <a href="https://gitee.com/deviling/devil-ai">
    <img src="https://img.shields.io/badge/NODE-18-blue.svg" alt="Node 18">
  </a>
</p>

## 📖 项目简介

基于 **Spring AI** 与 **MCP 框架** 实现的智能业务数据处理系统，通过AI技术赋能企业级数据操作，提供自然语言交互式业务处理能力。

## 🛠️ 技术架构

- **后端框架**: Spring Boot, Spring AI, Spring AI Alibaba
- **前端框架**: Vue3.0 (基于现代前端框架)
- **数据库**: MySQL
- **开发环境**:
    - JDK 17+
    - Node.js 18.x
    - MySQL 8.0+

## 🚀 快速开始

### 环境准备
1. 安装 [JDK 17](https://www.oracle.com/java/technologies/downloads/#java17)
2. 安装 [Node.js 18.x](https://nodejs.org/)
3. 安装 [MySQL 8.0+](https://dev.mysql.com/downloads/mysql/)

### 数据库初始化
```bash
# 1. 创建数据库
mysql -u root -p -e "CREATE DATABASE ai;"

# 2. 导入初始化SQL（假设SQL文件位于项目根目录/db/ai.sql）
mysql -u root -p devil_ai < db/ai.sql
```

### 后端服务启动
```bash
# 1. 启动核心服务（注意：国内网络建议配置Maven镜像源）
cd devil-mcp
mvn spring-boot:run

# 2. 启动AI助手服务（新终端窗口）
cd ../devil-assistant
mvn spring-boot:run
```

### 前端服务启动
```bash
# 进入前端目录
cd devil_assistant_web

# 安装依赖（国内建议使用npm镜像源）
npm install --registry=https://registry.npmmirror.com

# 启动开发服务器
npm run dev
```

## 🔍 常见问题

#### ❗ 依赖下载失败
- **Maven**: 在`settings.xml`中配置阿里云镜像源
- **NPM**: 使用 `npm config set registry https://registry.npmmirror.com`

#### 🔑 数据库连接配置
修改各模块的 `application.yml` 文件中的数据库连接信息：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/ai?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password
```

## 🤝 参与贡献
1. Fork 项目仓库
2. 创建特性分支 (`git checkout -b feature/awesome-feature`)
3. 提交代码变更 (`git commit -m 'Add some feature'`)
4. 推送至远程仓库 (`git push origin feature/awesome-feature`)
5. 提交 Pull Request

## 📄 开源协议
[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0)

---

> 🌐 项目地址：[Gitee](https://gitee.com/deviling/devil-ai)  
> 📧 反馈建议：321704933@qq.com