MCP 服务器

MySql MCP Server

无缝连接并与 MySQL 数据库交互。执行 SQL 查询，管理数据库连接，并直接通过 AI 助手检索数据。通过对 MySQL 数据的结构化访问来增强您的 AI 能力。

Tools

use_database

Switch to a different database.

set_readonly

Enable or disable read-only mode

list_tables

Get a list of tables in the current database.

describe_table

Get the structure of a specific table.

list_databases

Get a list of all accessible databases on the server.

status

Check the current database connection status.

connect

Connect to a MySQL database.

disconnect

Close the current MySQL database connection.

query

Execute an SQL query on the connected database.

README

MySQL MCP 服务器

一个用于 MySQL 数据库的模型上下文协议 (MCP) 服务器，使 AI 模型能够通过结构化接口与 MySQL 数据库交互。

概述

MySQL MCP 服务器提供了一个 AI 模型和 MySQL 数据库之间的桥梁，允许 AI 代理查询和分析 MySQL 数据。此实现遵循模型上下文协议规范，并提供 Web 服务器和 CLI 两种操作模式。

特性

MySQL 数据库连接管理
SQL 查询执行
表格列表和结构检查
数据库列表和选择
通过 SSE（服务器发送事件）进行实时状态监控
用于测试 MCP 工具的 Web 界面
支持 stdio 和 SSE 传输方法
Docker 部署就绪

安装

# 全局安装
npm install -g mysql-mcp

# 本地安装
npm install mysql-mcp

与 AI 助手一起使用

使用 Smithery.ai 上发布的服务器

MySQL MCP 服务器已发布在 Smithery.ai 上，可以轻松地与各种 AI 助手一起使用：

访问服务器: 访问 https://smithery.ai/server/@sussa3007/mysql-mcp
配置服务器:
- 设置您的 MySQL 数据库连接详细信息：
  - MYSQL_HOST
  - MYSQL_PORT
  - MYSQL_USER
  - MYSQL_PASSWORD
  - MYSQL_DATABASE
  - MYSQL_READONLY (可选，设置为 True 表示只读访问)
与支持的 AI 平台连接:
- Anthropic Claude
- Cursor AI
- Windsurf
- Cline
- Witsy
- Enconvo
- Goose
身份验证: 登录到 Smithery.ai 以保存您的配置并生成身份验证令牌。
在 AI 提示中使用: 连接后，您可以通过要求助手执行数据库操作，在 AI 对话中使用 MySQL 工具。

本地安装后使用

要使用本地开发的版本：

在您的项目目录中运行 npm link
如下配置您的设置文件：

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["mysql-mcp"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

工具

status

检查当前数据库连接状态。

输入: 无需参数
返回: 连接状态信息，包括主机、端口、数据库和用户名（如果已连接）。

connect

连接到 MySQL 数据库。

输入:
- host (可选字符串): 数据库服务器主机名或 IP 地址
- port (可选字符串): 数据库服务器端口
- user (可选字符串): 数据库用户名
- password (可选字符串): 数据库密码
- database (可选字符串): 要连接的数据库名称
返回: 连接成功消息或错误详细信息。