MySQL MCP 服务器

这是一个提供对 MySQL 数据库访问的 Model Context Protocol (MCP) 服务器。它允许代理执行针对 MySQL 数据库的 SQL 查询。

功能

• 执行 MySQL 数据库上的 SQL 查询：
  • 读取数据（SELECT 语句）
  • 创建表（CREATE TABLE 语句）
  • 插入数据（INSERT INTO 语句）
  • 更新数据（UPDATE 语句）
  • 删除数据（DELETE FROM 语句）
• 返回查询结果为 JSON 格式
• 可配置的数据库连接设置
• 带有唯一标识符的事务日志

先决条件

• Node.js (v14 或更高版本)
• MySQL 服务器
• MCP SDK

安装

1. 克隆或下载此仓库
2. 安装依赖项：

cd mysql-mcp-server
npm install

3. 构建服务器：

npm run build

配置

MySQL MCP 服务器使用以下环境变量进行配置：

• MYSQL_HOST：MySQL 服务器主机名（默认：'localhost'）
• MYSQL_PORT：MySQL 服务器端口（默认：3306）
• MYSQL_USER：MySQL 用户名（默认：'mcp101'）
• MYSQL_PASSWORD：MySQL 密码（默认：'123qwe'）
• MYSQL_DATABASE：MySQL 数据库名称（默认：'mcpdb'）

数据库设置

1. 创建 MySQL 数据库：

CREATE DATABASE mcpdb;

2. 创建具有访问数据库权限的 MySQL 用户：

CREATE USER 'mcp101'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON mcpdb.* TO 'mcp101'@'localhost';
FLUSH PRIVILEGES;

3. 创建测试表：

USE mcpdb;
CREATE TABLE products (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(255),
    price DECIMAL(10, 2)
);

MCP 配置

在不同的环境中配置 MySQL MCP 服务器：

• VS Code: 在 settings.json 中添加以下内容：

  {
      "mcp.servers": [
          {
              "name": "mysql-mcp-server",
              "type": "mysql",
              "host": "localhost",
              "port": 3306,
              "database": "mcpdb",
              "user": "mcp101"
          }
      ]
  }
  

使用说明

在对话中使用以下语法调用工具：

{
    "tools": {
        "mysql-mcp-server": {
            "function": "executeQuery",
            "args": {
                "query": "SELECT * FROM products LIMIT 5;"
            }
        }
    }
}

可用工具

执行查询

用于执行任意的 SQL 查询。

参数

• query：要执行的 SQL 查询字符串。

示例

{
    "query": "SELECT * FROM products LIMIT 5;"
}

创建表

用于创建新的数据库表。

参数

• query：CREATE TABLE 语句。

示例

{
    "query": "CREATE TABLE users (id INT PRIMARY KEY, username VARCHAR(255), email VARCHAR(255));"
}

插入数据

用于向表中插入新记录。

参数

• query：INSERT INTO 语句。

示例

{
    "query": "INSERT INTO products (name, price) VALUES ('Laptop', 999.99), ('Smartphone', 499.99);"
}

更新数据

用于更新表中的记录。

参数

• query：UPDATE 语句。

示例

{
    "query": "UPDATE products SET price = 899.99 WHERE name = 'Laptop';"
}

删除数据

用于从表中删除记录。

参数

• query：DELETE FROM 语句。

示例

{
    "query": "DELETE FROM products WHERE name = 'Smartphone';"
}

安全注意事项

• 使用专用 MySQL 用户，具有适当的权限
• 考虑使用只读权限，如果只需要查询数据
• 安全存储敏感信息，如数据库凭证
• 所有操作均带有唯一事务 ID 进行审计