MySQL MCP Server

@yuki777

Basic information

About MySQL MCP Server

No overview available yet

MySQL MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mysql-mcp-server-yuki777": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/yuki777/mysql-mcp-server",
        "--host",
        "127.0.0.1",
        "--port",
        "13306",
        "--user",
        "root"
      ]
    }
  }
}

MySQL MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MySQL MCP Server?

MySQL MCP Server enables large language models (LLMs) to directly execute SQL queries on a local MySQL or MariaDB database by implementing the Model Context Protocol (MCP). It is built for developers and AI applications that need LLMs to safely interact with relational databases.

How to use MySQL MCP Server?

Run it via npx with database connection options, or use a JSON config file. The server starts in stdio mode and accepts tool calls for connecting, querying, and managing connections. Example: npx -y https://github.com/yuki777/mysql-mcp-server --host 127.0.0.1 --port 13306 --user root. After starting, LLMs invoke MCP tools like execute_query and connect_database.

Key features of MySQL MCP Server

Executes SQL queries directly from LLM tool calls
Lists databases, tables, and table structures
M‑CP compliant, integrates with any MCP‑capable LLM
Uses stdio communication, no network port binding
Saves connection profiles locally for reuse
Manages multiple profiles and switches between them

Use cases of MySQL MCP Server

Allow an LLM to explore and query a local database for data analysis
Let an LLM manage database schemas by running DDL statements
Switch between development and production databases using saved profiles
Securely connect an LLM to a database without exposing network ports

Frequently asked questions

What are the runtime requirements?

Node.js 20.0.0 or higher and MySQL 5.7+ or MariaDB server are required.

Where are saved connection profiles stored?

Profiles are stored locally in `~/.mysql-mcp-connections.json` in the user’s home directory.

Does this server expose a network port?

No, it uses stdio communication by default, avoiding port conflicts and improving security. An optional HTTP server port can be configured but is not used in stdio mode.

Can I connect to multiple databases without restarting?

Yes, the server separates startup from database connection. You can use `connect_database` or `connect_by_profile` tools to switch between databases at runtime.

How do I configure a custom query timeout and result limit?

Use the `--query-timeout` (default 30000 ms) and `--max-results` (default 1000 rows) command‑line options or set them in the JSON config file.

Comments

More Databases MCP servers

PostgreSQL

modelcontextprotocol

Model Context Protocol Servers

88.1K

Lawstronaut

Lawstronaut-FZCO

Access millions of official legal and regulatory source documents from 155+ jurisdictions via MCP. Lawstronaut supports AI agents with structured legal research, legal data, laws, regulations, cases, guidance, official s