Skip to main content
Glama
huanglixinccc

MySQL MCP Server

by huanglixinccc
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

MySQL MCP Server

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: MCP MySQL Server

快速开始

npm install
cp .env.example .env
# 编辑 .env 填入 MySQL 连接信息

npm run start:dev   # 开发模式
npm run build       # 构建
npm run start:prod  # 生产运行

在 Claude Code 中配置

先构建项目：

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

在 Codex 中配置

先构建项目：

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 中配置

项目已包含 .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。

This server cannot be installed

F
license - not found
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

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