JinDaGe - mysql-database-server-6m3 MCP Details

article

README

🚀 @f4ww4z/mcp-mysql-server

这是一个提供MySQL数据库操作的模型上下文协议（Model Context Protocol）服务器，允许AI模型通过标准化接口与MySQL数据库进行交互。

🚀 快速开始

该服务器允许AI模型通过标准化接口与MySQL数据库交互，为数据库操作提供了便捷的途径。

✨ 主要特性

安全连接处理，带自动清理功能
预编译语句支持以防止SQL注入
全面的错误处理和验证
TypeScript支持
自动化连接管理

📦 安装指南

通过Smithery安装

要自动通过Smithery安装MySQL服务器用于Claude Desktop，可使用以下命令：

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"
      }
    }
  }
}

可用工具

1. connect_db

使用提供的凭据建立MySQL数据库连接。

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

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",
  arguments: {}
});

5. describe_table

获取特定表的结构。

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

安全性

使用预编译语句防止SQL注入
通过环境变量支持安全密码处理
查询执行前进行验证
连接使用后自动关闭

错误处理

该服务器为常见问题提供详细的错误消息：

连接失败
无效查询
缺少参数
数据库错误

🤝 贡献

欢迎贡献！请随意提交Pull Request到 https://github.com/f4ww4z/mcp-mysql-server

📄 许可证

MIT

mysql-database-server-6m3