MCP 服务器

MCP MySQL Server

一个模型上下文协议服务器，它使人工智能模型能够通过标准化的接口与 MySQL 数据库交互，并提供查询、执行命令和管理数据库模式的工具。

README

@enemyrr/mcp-mysql-server

一个提供 MySQL 数据库操作的模型上下文协议服务器。该服务器使 AI 模型能够通过标准化接口与 MySQL 数据库进行交互。

Cursor IDE 的安装与设置

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 MySQL 数据库服务器，请执行以下操作：

npx -y @smithery/cli install @enemyrr/mcp-mysql-server --client claude

手动安装

克隆并构建项目：

git clone https://github.com/enemyrr/mcp-mysql-server.git
cd mcp-mysql-server
npm install
npm run build

在 Cursor IDE 设置中添加服务器：
- 打开命令面板 (Cmd/Ctrl + Shift + P)
- 搜索 "MCP: Add Server"
- 填写以下字段：
  - 名称: mysql
  - 类型: command
  - 命令: node /absolute/path/to/mcp-mysql-server/build/index.js

注意: 将 /absolute/path/to/ 替换为您克隆和构建项目的实际路径。

数据库配置

您可以通过三种方式配置数据库连接：

.env 文件中的数据库 URL (推荐):

DATABASE_URL=mysql://user:password@host:3306/database

.env 文件中的单独参数:

DB_HOST=localhost
DB_USER=your_user
DB_PASSWORD=your_password
DB_DATABASE=your_database

通过工具直接连接:

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    url: "mysql://user:password@host:3306/database"
    // OR
    workspace: "/path/to/your/project" // 将使用项目的 .env 文件
    // OR
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

可用工具

1. connect_db

使用 URL、工作区路径或直接凭据连接到 MySQL 数据库。

2. query

执行 SELECT 查询，并带有可选的预处理语句参数。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT * FROM users WHERE id = ?",
    params: [1]
  }
});

3. execute

执行 INSERT、UPDATE 或 DELETE 查询，并带有可选的预处理语句参数。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "execute",
  arguments: {
    sql: "INSERT INTO users (name, email) VALUES (?, ?)",
    params: ["John Doe", "john@example.com"]
  }
});

4. list_tables

列出已连接数据库中的所有表。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables"
});

5. describe_table

获取特定表的结构。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "describe_table",
  arguments: {
    table: "users"
  }
});

6. create_table

创建具有指定字段和索引的新表。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "create_table",
  arguments: {
    table: "users",
    fields: [
      {
        name: "id",
        type: "int",
        autoIncrement: true,
        primary: true
      },
      {
        name: "email",
        type: "varchar",
        length: 255,
        nullable: false
      }
    ],
    indexes: [
      {
        name: "email_idx",
        columns: ["email"],
        unique: true
      }
    ]
  }
});

7. add_column

向现有表添加新列。

use_mcp_tool({
  server_name: "mysql",
  tool_name: "add_column",
  arguments: {
    table: "users",
    field: {
      name: "phone",
      type: "varchar",
      length: 20,
      nullable: true
    }
  }
});