MySQL Ops MCP

MySQL Ops MCP

English | 简体中文

[npm version] [License: MIT] [Node.js] [MCP] [GitHub stars]

A MySQL database MCP Server. Let AI tools like Claude Code / Cursor / Codex talk to your MySQL databases in natural language — browse databases and tables, inspect schemas, run queries, and perform CRUD operations, with destructive operations (DELETE / DROP) gated behind explicit user approval.

Features

• 🗄️ Schema browsing: list databases, list tables, describe table structure, full table info (indexes, DDL, stats)
• 🔍 Queries: run SELECT queries against any database
• ✏️ CRUD: create tables, insert, update — with SQL-statement validation per tool
• 🔐 Approval-gated destructive ops: delete_data and drop_table always require explicit user confirmation in the client
• 🔌 Zero install: runs via npx, configured entirely through environment variables

Installation

Requires Node.js 18+. No clone or build needed — npx fetches and runs the published npm package on first use (see the config below).

To build from source instead (e.g. for development):

git clone https://github.com/GT-dinuo/mysql-ops-mcp.gitcd mysql-ops-mcpnpm installnpm run build

Build output goes to dist/; the entry point is dist/index.js.

Configuration

In each project where you want to use this tool, create (or append to) .mcp.json:

{  "mcpServers": {    "mysql": {      "command": "npx",      "args": ["-y", "mysql-ops-mcp"],      "env": {        "DB_HOST": "localhost",        "DB_PORT": "3306",        "DB_USER": "root",        "DB_PASSWORD": "your_password",        "DB_DATABASE": "your_database"      }    }  }}

If you built from source, point the command at the local build instead: "command": "node", "args": ["/absolute/path/to/mysql-ops-mcp/dist/index.js"].

Environment Variables

Usage

Once configured, just ask in natural language in your AI tool:

List all databasesShow the structure of the users tableQuery the 10 most recent ordersGet full info for the users table — indexes and DDL includedInsert a test record into the users tableDelete the test record you just inserted   ← the client will ask for your approval first

Destructive operations (delete_data, drop_table) are always confirmed by the MCP client before execution — nothing irreversible happens silently.

Tool List

Security

1. Destructive operations require approval: delete_data and drop_table are gated by the MCP client's tool-call confirmation — approve or reject each one.
2. Statement validation: each write tool only accepts its own SQL verb (e.g. query rejects anything but SELECT).
3. Use a least-privilege account: don't connect as root in production — create a MySQL user scoped to the databases the AI may touch.
4. Never commit credentials: .env / .mcp.json with real passwords must stay out of version control (.gitignore already covers .env).

Testing the Connection

After configuring .env (copy from env.example), you can verify connectivity before wiring up the client:

cp env.example .env   # fill in real credentialsnpm run test-connection

Development

npm run dev    # watch mode, recompiles on changenpm run build  # build to dist/npm start      # run the built Server

License

MIT © 2026 mysql-ops-mcp