返回市场
MySQL-MCP

MySQL-MCP

作者:sussa300718 星标更新:2025-04-03

项目介绍

smithery 徽章

<a href="https://glama.ai/mcp/servers/@sussa3007/mysql-mcp"> <img width="380" height="200" src="https://gips0.baidu.com/it/u=696262659,639276378&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

MySQL MCP 服务器

许可:MIT

MySQL 数据库的 Model Context Protocol (MCP) 服务器,使 AI 模型能够通过结构化接口与 MySQL 数据库进行交互。

概述

MySQL MCP 服务器在 AI 模型和 MySQL 数据库之间提供了一个桥梁,允许 AI 代理查询和分析 MySQL 数据。此实现遵循 Model Context Protocol 规范,并提供了 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 助手一起使用:

  1. 访问服务器:访问 https://smithery.ai/server/@sussa3007/mysql-mcp

  2. 配置服务器

    • 设置您的 MySQL 数据库连接详情:
      • MYSQL_HOST
      • MYSQL_PORT
      • MYSQL_USER
      • MYSQL_PASSWORD
      • MYSQL_DATABASE
      • MYSQL_READONLY(可选,设置为 True 以启用只读访问)
  3. 连接支持的 AI 平台

    • Anthropic Claude
    • Cursor AI
    • Windsurf
    • Cline
    • Witsy
    • Enconvo
    • Goose
  4. 认证:登录 Smithery.ai 保存您的配置并生成认证令牌。

  5. 在 AI 提示中使用:一旦连接,您可以在 AI 对话中利用 MySQL 工具,请求助手执行数据库操作。

在本地安装后使用

要使用本地开发的版本:

  1. 在项目目录中运行 npm link
  2. 如下配置您的设置文件:
{
  "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(可选字符串):要连接的数据库名称
  • 返回:连接成功消息或错误详情。

disconnect

关闭当前 MySQL 数据库连接。

  • 输入:无需参数
  • 返回:断开连接成功消息或错误详情。

query

在连接的数据库上执行 SQL 查询。

  • 输入
    • sql(字符串):要执行的 SQL 查询
    • params(可选数组):预处理语句的参数
  • 返回:查询结果作为 JSON 或错误消息。

list_tables

获取当前数据库中的表列表。

  • 输入:无需参数
  • 返回:当前数据库中的表名列表。

describe_table

获取特定表的结构。

  • 输入
    • table(字符串):要描述的表名
  • 返回:表结构详情,包括列、类型、键和其他属性。

list_databases

获取服务器上所有可访问数据库的列表。

  • 输入:无需参数
  • 返回:服务器上可用的数据库名列表。

use_database

切换到不同的数据库。

  • 输入
    • database(字符串):要切换到的数据库名称
  • 返回:确认消息或错误详情。

关键词

mysql, mcp, 数据库, ai, 模型上下文协议

许可证

MIT