@f4ww4z/mcp-mysql-server

基本能力

产品定位

mcp-mysql-server 是一个专门用于 MySQL 数据库操作的 MCP 服务器，旨在为 AI 模型提供标准化的数据库交互接口。

核心功能

• 连接 MySQL 数据库
• 执行 SELECT 查询
• 执行 INSERT、UPDATE 和 DELETE 操作
• 列出数据库中的所有表
• 获取表结构信息

适用场景

• AI 模型需要访问和操作 MySQL 数据库
• 需要安全地执行数据库查询和操作
• 需要自动化的数据库连接管理

工具列表

1. connect_db：使用提供的凭据建立与 MySQL 数据库的连接。
2. query：执行 SELECT 查询，支持预编译语句参数。
3. execute：执行 INSERT、UPDATE 或 DELETE 查询，支持预编译语句参数。
4. list_tables：列出连接数据库中的所有表。
5. describe_table：获取特定表的结构信息。

常见问题解答

• 连接失败：检查主机、用户名、密码和数据库名称是否正确。
• 无效查询：确保 SQL 语法正确。
• 缺少参数：确保所有必需的参数都已提供。
• 数据库错误：查看详细的错误消息以了解具体问题。

使用教程

使用依赖

无特殊依赖，只需安装 Node.js 和 npm。

安装教程

通过 Smithery 安装

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

手动安装

npx @f4ww4z/mcp-mysql-server

配置

在 MCP 设置配置文件中设置以下环境变量：

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@f4ww4z/mcp-mysql-server"],
      "env": {
        "MYSQL_HOST": "your_host",
        "MYSQL_USER": "your_user",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

调试方式

安装完成后，可以通过执行以下命令测试连接和查询功能：

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。