MCP Server for MySQL based on NodeJS

Name: MCP Server for MySQL based on NodeJS
Author: zhaoxin34

@zhaoxin34

代码仓库

关于 MCP Server for MySQL based on NodeJS

暂无概览

基本信息

分类

数据库

许可证

MIT license

运行时

node

传输方式

stdio

发布者

zhaoxin34

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-mysql-zhaoxin34": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "install",
        "@benborla29/mcp-server-mysql",
        "--client",
        "claude"
      ]
    }
  }
}

工具

Execute read-only SQL queries against the connected database

概览

What is MCP Server for MySQL based on NodeJS?

A Model Context Protocol server that provides read-only access to MySQL databases, enabling LLMs to inspect database schemas and execute read-only queries. It is designed for developers and AI applications that need safe, structured database interaction.

How to use MCP Server for MySQL based on NodeJS?

Install via Smithery (npx -y @smithery/cli@latest install @benborla29/mcp-server-mysql), MCP Get, or manually with npm/pnpm (npm install -g @benborla29/mcp-server-mysql). Configure using environment variables (e.g., MYSQL_HOST, MYSQL_PORT) and invoke the mysql_query tool with a read-only SQL string.

Key features of MCP Server for MySQL based on NodeJS

Execute read-only SQL queries with prepared statements
Automatically discover table schemas, indexes, and foreign keys
SQL injection prevention and rate limiting
Query result caching and configurable timeouts
Comprehensive query logging and performance metrics

Use cases of MCP Server for MySQL based on NodeJS

Let an LLM generate and run analytical SELECT queries against your MySQL database
Provide safe read-only database access for AI assistants without risking data modifications
Automatically document database schemas by inspecting tables, columns, and relationships
Enable conversational data analysis by letting an LLM answer natural‑language questions with live SQL queries

FAQ from MCP Server for MySQL based on NodeJS

How does read‑only access work?

All queries are executed inside a READ ONLY transaction. The server enforces read‑only semantics and supports prepared statements for parameterised queries.

What are the runtime dependencies?

You need Node.js and a MySQL server (supports caching_sha2_password and mysql_native_password). The server can be installed globally via npm or run via npx.

What environment variables must I set?

At minimum: MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASS, and optionally MYSQL_DB. Advanced options for pooling, timeouts, caching, rate limiting, SSL, and logging are also available.

Does the server support SSL/TLS?

Yes. Set MYSQL_SSL to true to enable encrypted connections.

How do I troubleshoot connection issues?

Verify MySQL is running, check credentials and permissions, and ensure the correct authentication plugin is used. For MySQL 8.0+ you may need a user created with mysql_native_password. Use Smithery diagnostics (smithery diagnose) or manual log checking.