MySQL MCP Server with Kimi AI

基于 NestJS + TypeScript + MySQL 的 MCP 服务器，集成 Kimi AI 实现自然语言数据库操作。

功能特性

✅ 严格遵循 MCP 协议标准
✅ 支持数据库增删查改操作
✅ 集成 Kimi AI（通过 prompt 工程实现工具调用）
✅ SSE 流式响应
✅ 生产级安全措施（SQL 注入防护、表白名单、查询限制）
✅ 前端聊天测试界面

项目结构

mysql-mcp-server/
├── src/
│   ├── main.ts                    # 应用入口
│   ├── app.module.ts              # 根模块
│   ├── config/                    # 配置模块
│   │   ├── config.module.ts
│   │   └── config.service.ts
│   ├── database/                  # 数据库模块
│   │   ├── database.module.ts
│   │   └── database.service.ts
│   ├── mcp/                       # MCP 服务模块
│   │   ├── mcp.module.ts
│   │   └── mcp-server.service.ts
│   └── chat/                      # 聊天 API 模块
│       ├── chat.module.ts
│       ├── chat.controller.ts
│       ├── chat.service.ts
│       └── kimi.service.ts
├── frontend/                      # 前端测试界面
│   ├── index.html
│   └── app.js
├── init-database.sql              # 数据库初始化脚本
├── .env                           # 环境变量配置
└── package.json

快速开始

1. 初始化数据库

mysql -u root -p123456 < init-database.sql

2. 安装依赖

pnpm install

3. 配置环境变量

已创建 .env 文件，包含：

数据库连接信息
Kimi API 密钥
安全配置

4. 编译项目

pnpm run build

5. 启动服务

方式 A：Chat API 服务（带前端 SSE）

pnpm start

服务将启动：

Chat API: http://localhost:3000
MCP Server: 自动启动（子进程）
前端测试：打开 frontend/index.html

方式 B：独立 MCP Server（给 Kiro/Claude 用）

pnpm run start:mcp

这会启动一个通过 stdio 通信的 MCP Server，可以被 Kiro IDE、Claude Desktop 等 MCP 客户端调用。

详细配置请查看 MCP-SETUP.md

MCP 工具列表

list_tables - 列出所有表
get_schema - 获取表结构
query_database - 执行 SELECT 查询
insert_record - 插入数据
update_record - 更新数据
delete_record - 删除数据

安全特性

✅ SQL 注入防护（参数化查询）
✅ 表权限控制（可配置允许访问的表和只读表）
✅ 操作权限控制（可配置每个表允许的操作）
✅ 查询结果限制（最多 1000 条）
✅ 禁止危险 SQL 关键字（DROP TABLE, DROP DATABASE, TRUNCATE 等）
✅ 审计日志（记录所有操作和数据变更）
✅ 数据变更追踪（记录修改前后的数据对比）
✅ 输入验证

详细配置请查看 PERMISSIONS.md

使用示例

在聊天界面中输入：

"查询所有用户"
"插入一个新用户，用户名是 test，邮箱是 test@example.com，年龄是 25"
"更新 id 为 1 的用户年龄为 30"
"删除 id 为 3 的用户"
"显示 users 表的结构"

架构说明

本项目采用真正的 MCP 协议架构：

┌─────────────────┐         ┌──────────────────┐
│  MCP Server     │         │  Chat API        │
│  (独立进程)      │←────────│  (NestJS)        │
│  stdio 通信     │  MCP    │  SSE to 前端     │
└─────────────────┘ Client  └──────────────────┘
         ↑
         │ stdio
    ┌────┴─────┐
    │   Kiro   │
    │  Claude  │
    └──────────┘

MCP Server：独立运行，通过 stdio 通信，符合 MCP 标准
Chat API：作为 MCP Client，连接到 MCP Server
前端 SSE：通过 Chat API 获取流式响应

技术栈

NestJS 10.x
TypeScript 5.x
TypeORM 0.3.x
MySQL 8.x
@modelcontextprotocol/sdk（标准 MCP 协议）
Kimi API (Moonshot AI)

开发模式

pnpm run dev

配置文档

MCP-SETUP.md - MCP Server 配置指南（Kiro/Claude）
PERMISSIONS.md - 权限和安全配置

注意事项

确保 MySQL 服务已启动
确保 Kimi API Key 有效
生产环境请修改 API_KEY 和数据库密码
可通过 database-permissions.json 调整表权限
所有操作都会记录到 logs/audit.log

MySQL MCP Server