MCP 服务器

MySQL MCP Server

Enables natural language database operations on MySQL databases with AI integration, supporting CRUD operations, schema inspection, and audit logging with built-in security features including SQL injection protection and permission controls.

README

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  │
    └──────────┘