MySQL只读查询服务器

基于NodeJS的MySQL模型上下文协议服务器,提供只读数据库访问,允许LLMs检查数据库模式和执行只读查询。

  • by hkk101
  • 本地部署
  • 更新于
在 GitHub 查看 hkk101/mcp-server-mysql

使用说明

基于NodeJS的MySQL MCP服务器

一种模型上下文协议服务器,提供对MySQL数据库的只读访问。此服务器使LLM能够检查数据库模式并执行只读查询。

组件

工具

  • mysql_query
    • 对连接的数据库执行只读SQL查询
    • 输入: sql (string):要执行的SQL查询
    • 所有查询都在只读事务中执行

资源

服务器为数据库中的每个表提供架构信息:

  • 持微软签名的表模式
    • 每个表的JSON模式信息
    • 包括列名和数据类型
    • 从数据库元数据中自动发现

使用Claude Desktop

要将此服务器与Claude Desktop应用程序一起使用,请将以下配置添加到您的“mcpServers”部分 claude_desktop_config.json:

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name"
      }

    }
  }
}

替换 /db_name 使用您的数据库名称,或将其留空以检索所有数据库。

故障排除

如果您遇到错误“无法连接到MCP服务器MCP服务器mysql”,您可能需要显式 设置所有必需二进制文件的路径,如下面的配置:

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "/path/to/npx/binary/npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql",
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name"
        "PATH": "/path/to/node/bin:/usr/bin:/bin" <-- Add this
      }

    }
  }
}

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息,请参阅项目存储库中的LICENSE文件。