MySQL MCP 服务器

版本：0.1.0

一个用于与 MySQL 数据库交互的模型上下文协议（MCP）服务器。此服务器允许 MCP 客户端（如 AI 助手）查询和修改配置的 MySQL 数据库中的数据。

特性

• 使用标准连接参数连接到 MySQL 数据库。
• 提供 MCP 工具以执行 SQL 查询和语句。
• 支持只读查询 (SELECT, SHOW, DESCRIBE)。
• 通过环境变量（MYSQL_ALLOW_WRITE_OPS）支持写操作 (INSERT, UPDATE, DELETE)，该变量设为 true 可启用这些操作，默认禁用（写操作不可用）。注意： 启用写操作允许 MCP 客户端修改您的数据库。请谨慎使用。
• 通过标准输入/输出（stdio）进行通信。

安装

# 作为项目依赖安装（推荐在其他项目中使用）
npm install

# 或，如果需要作为独立全局工具：
# 1. 构建项目：
#    npm run build
# 2. 全局链接：
#    npm link 
#    （或使用 `npm install -g .` 如果已发布）

配置

此服务器需要以下环境变量设置以进行数据库连接：

• MYSQL_HOST：MySQL 服务器的主机名或 IP 地址。
• MYSQL_USER：用于连接到数据库的用户名。
• MYSQL_PASSWORD：指定用户的密码。
• MYSQL_DATABASE：要连接到的数据库名称。
• MYSQL_PORT：（可选）MySQL 服务器的端口号（默认为 3306）。
• MYSQL_ALLOW_WRITE_OPS：（可选）设为 true 可启用 insert, update, 和 delete 工具，默认为 false（写操作禁用）。注意： 启用写操作允许 MCP 客户端修改您的数据库。请谨慎使用。

这些变量需要在服务器进程运行的环境中可用。如何设置它们取决于您的操作系统和运行服务器的方式（例如，.env 文件、系统环境变量、shell 导出）。

使用

配置完成后并构建（npm run build），您可以运行服务器：

# 如果已全局链接
mysql-server

# 或直接使用 node 运行
node build/index.js 

服务器将启动并在 stderr 中打印 MySQL MCP 服务器在 stdio 上运行，然后监听标准输入/输出上的 MCP 请求。您通常会配置您的 MCP 客户端（例如 AI 助手集成）连接到此服务器进程。

可用工具

服务器为 MCP 客户端公开以下工具：

1. query

• 描述： 执行只读 SQL 查询（SELECT, SHOW, DESCRIBE）针对配置的数据库。
• 输入模式：

  {
    "type": "object",
    "properties": {
      "sql": {
        "type": "string",
        "description": "要执行的只读 SQL 查询 (SELECT, SHOW, DESCRIBE)。"
      }
    },
    "required": ["sql"]
  }
  

• 输出： 以 JSON 字符串形式在 MCP 响应 content 中返回查询结果。如果查询不是只读或出现数据库错误，将返回错误。

2. insert

• 描述： 执行 INSERT SQL 语句。需要 MYSQL_ALLOW_WRITE_OPS 设为 true。
• 输入模式：

  {
    "type": "object",
    "properties": {
      "sql": {
        "type": "string",
        "description": "要执行的 INSERT SQL 语句。"
      }
    },
    "required": ["sql"]
  }
  

• 输出： 成功时返回包含插入记录数的消息，失败时返回错误消息。

3. update

• 描述： 执行 UPDATE SQL 语句。需要 MYSQL_ALLOW_WRITE_OPS 设为 true。
• 输入模式：

  {
    "type": "object",
    "properties": {
      "sql": {
        "type": "string",