MySQL MCP Server

一个强大的 MCP 服务器，提供对 MySQL 数据库的直接访问。该服务器使 AI 助手能够与 MySQL 数据库交互、执行 SQL 查询，并通过简单的接口管理数据库内容。

功能特性

资源 (Resources)

• 通过 note:///{id} URI 访问数据库中存储的笔记
• 每个笔记都有标题和内容
• 纯文本 MIME 类型，便于内容访问

工具 (Tools)

• create_note - 在数据库中创建新的文本笔记
  • 需要标题和内容作为必需参数
  • 将笔记存储在 MySQL 数据库中
• list_tables - 列出连接数据库中的所有表
• count_tables - 获取数据库中的表总数
• search_tables - 使用 LIKE 模式搜索表
• describe_table - 获取特定表的结构
• execute_sql - 执行自定义 SQL 查询

前置要求

• Node.js 18 或更高版本
• MySQL 服务器已安装并运行
• 具有适当权限的数据库

安装

通过 npm 安装

npm install -g @hsbase/mysql-mcp

或者使用 npx（推荐）：

npx -y @hsbase/mysql-mcp

配置

在 Cursor 中使用

在 Cursor 的 MCP 配置文件中添加服务器配置：

配置文件位置: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mysql-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hsbase/mysql-mcp"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      },
      "timeout": 90
    }
  }
}

在 Claude Desktop 中使用

在 Claude Desktop 配置文件中添加服务器配置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@hsbase/mysql-mcp"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_USER": "your_username",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

使用示例

安装后，您可以在与 AI 助手的对话中使用 MySQL MCP 服务器：

列出数据库中的所有表

请列出我的 MySQL 数据库中的所有表。

执行 SQL 查询

运行这个 SQL 查询：SELECT * FROM users LIMIT 5

创建笔记

创建一个标题为"会议记录"的笔记，内容为"讨论了项目时间表并分配了任务。"

搜索表

搜索包含 'user' 的表名

查看表结构

显示 users 表的结构

环境变量

| 变量名 | 描述 | 必需 | |--------|------|------| | MYSQL_HOST | MySQL 服务器主机地址 | 是 | | MYSQL_USER | MySQL 用户名 | 是 | | MYSQL_PASSWORD | MySQL 密码 | 是 | | MYSQL_DATABASE | 要连接的数据库名 | 是 |

开发

本地开发

git clone <repository-url>
cd mysql-mcp-server-publish
npm install
npm start

许可证

MIT

作者

yupeng39678