# yulan-mcp

**Repository Path**: openus/yulan-mcp

## Basic Information

- **Project Name**: yulan-mcp
- **Description**: MCP服务实现，目前支持对数据库的操作
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-21
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCP Database Service

基于Spring Boot 3.x + Spring AI的MCP数据库服务

## 功能特性

- 查看数据库所有表
- 查看表结构
- 清空表数据
- 删除表
- 统计表记录数
- 查询表数据（支持条件查询和限制行数）
- 插入单条数据
- 批量插入数据
- 更新数据
- 删除数据
- 批量删除数据

## 技术栈

- Spring Boot 3.2.5
- MyBatis-Plus 3.5.6
- Spring AI 1.0.0-SNAPSHOT
- MySQL 8.0
- Java 17

## MCP工具列表

### 1. list\_tables

获取数据库中所有表

### 2. describe\_table

查看表结构

- 参数: tableName (表名)

### 3. truncate\_table

清空表数据

- 参数: tableName (表名)

### 4. drop\_table

删除表

- 参数: tableName (表名)

### 5. count

统计表记录数

- 参数: tableName (表名)

### 6. select

查询表数据

- 参数:
  - tableName (表名)
  - conditions (可选，查询条件)
  - limit (可选，限制返回行数)

### 7. insert

插入单条数据

- 参数:
  - tableName (表名)
  - data (要插入的数据)

### 8. batch\_insert

批量插入数据

- 参数:
  - tableName (表名)
  - dataList (要插入的数据列表)

### 9. update

更新数据

- 参数:
  - tableName (表名)
  - data (要更新的数据)
  - conditions (更新条件)

### 10. delete

删除数据

- 参数:
  - tableName (表名)
  - conditions (删除条件)

### 11. batch\_delete

批量删除数据

- 参数:
  - tableName (表名)
  - conditionsList (删除条件列表)

## 运行方式

### 编译项目

```bash
mvn clean package
```

### 运行服务

```bash
java -jar target/mcp-database-service-1.0.0.jar
```

## MCP客户端配置

在MCP客户端配置文件中添加：

## 注意事项

1. 确保MySQL数据库已启动并可访问
2. 确保数据库用户有足够的权限执行相关操作
3. 生产环境请修改数据库连接密码
4. 批量操作时注意数据量，避免内存溢出

<br />

## trae 中配置mcp服务:

```java
{
  "mcpServers": {
    "local_map": {
        // sse地址
      "url": "http://localhost:8080/sse"
    }
  }
}

```