Provides a secure gateway for AI agents to access MySQL databases, supporting read/write operations with risk-level gating, AST-based validation, and full audit trails.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MySQL MCP Server list all tables in the database"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI-to-DB Secure Gateway — 不只是一个 MCP Server，而是 AI 与数据库之间的安全执行网关。
基于 NestJS + TypeScript 构建，通过 MCP 协议为 Claude Code 等 AI 助手提供对 MySQL 数据库的受控访问能力。核心目标是在 AI 的灵活性与数据库的安全性之间建立可信边界。
传统数据库工具直接暴露执行能力，对 AI 调用者而言风险极高。本项目的核心设计原则：
最小权限：工具按风险分级，高危操作默认关闭
AST 级校验：不依赖关键字匹配，通过 SQL Parser 解析语法树做严格校验
可审计：每次操作完整记录，行为可追溯
可控执行：AI 可以分析（EXPLAIN）但不能随意破坏
Related MCP server: MySQL MCP Server
npm install
cp .env.example .env
# 编辑 .env 填入 MySQL 连接信息
npm run start:dev # 开发模式
npm run build # 构建
npm run start:prod # 生产运行先构建项目：
npm run build使用 claude mcp add 命令注册（推荐，写入用户级全局配置）：
claude mcp add mysql node /path/to/mysql-mcp-nest/dist/main.js \
--scope user \
-e DB_HOST=127.0.0.1 \
-e DB_PORT=3306 \
-e DB_USER=root \
-e DB_PASSWORD=your_password \
-e DB_DATABASE=your_database \
-e PERMISSION_MODE=read_write \
-e AUDIT_LOG_ENABLED=true \
-e AUDIT_LOG_DIR=/path/to/mysql-mcp-nest/logs--scope user：写入 ~/.claude.json，所有项目均可使用
--scope project：写入当前项目的 .claude.json，仅当前项目可用
注册后重启 claude，执行 /mcp 验证连接状态：
❯ /mcp
mysql connected先构建项目：
npm run build使用 codex mcp add 命令注册到 Codex：
codex mcp add mysql \
--env DB_HOST=127.0.0.1 \
--env DB_PORT=3306 \
--env DB_USER=root \
--env DB_PASSWORD=your_password \
--env DB_DATABASE=your_database \
--env PERMISSION_MODE=read_write \
--env AUDIT_LOG_ENABLED=true \
--env AUDIT_LOG_DIR=/path/to/mysql-mcp-nest/logs \
-- node /path/to/mysql-mcp-nest/dist/main.js验证配置是否写入成功：
codex mcp list
codex mcp get mysql注册后重启 Codex，或重新开启一个 Codex 会话，让 MCP 配置生效。
连接成功后即可直接使用：
列出 your_database 中的所有表项目已包含 .cursor/mcp.json，Cursor 打开本仓库后会注册 mysql MCP Server：
{
"mcpServers": {
"mysql": {
"type": "stdio",
"command": "node",
"args": ["${workspaceFolder}/dist/main.js"],
"envFile": "${workspaceFolder}/.env",
"env": {
"AUDIT_LOG_DIR": "${workspaceFolder}/logs"
}
}
}
}使用前先构建项目，并确认 .env 里已填好 MySQL 连接信息：
npm run build然后重启 Cursor，或在 Cursor Settings → MCP 中刷新/启用 mysql。
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Runtime permission, approval, and audit layer for AI agent tool execution.
Operate your Linux servers from your LLM. Every action runs through an auditable allowlist.
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/huanglixinccc/mysql-mcp-nest'
If you have feedback or need assistance with the MCP directory API, please join our Discord server