MCP Server for MySQL based on NodeJS

MCP Server for MySQL based on NodeJS

site icon
2025.05.08 0
JavaScript数据库访问工具MySQL 只读访问数据库
hkk101_mcp-server-mysql 是一个基于 NodeJS 的 MCP 服务器,专门用于提供对 MySQL 数据库的只读访问。该服务器允许 LLMs(大型语言模型)检查数据库模式并执行只读查询。
View on GitHub

Overview

基本能力

产品定位

hkk101_mcp-server-mysql 是一个数据库访问工具,专门为 MySQL 数据库提供只读访问能力,适用于需要查询数据库但不进行修改的场景。

核心功能

  • mysql_query 工具:执行只读 SQL 查询,输入为 SQL 查询字符串,所有查询都在只读事务中执行。
  • 表模式资源:提供数据库中每个表的 JSON 模式信息,包括列名和数据类型,这些信息从数据库元数据中自动发现。

适用场景

  • 需要查询 MySQL 数据库但不进行修改的场景。
  • 需要自动发现数据库模式信息的场景。
  • 与 Claude Desktop 应用集成,提供数据库查询能力。

工具列表

  • mysql_query:执行只读 SQL 查询。

常见问题解答

  • 连接问题:如果遇到 "Could not connect to MCP server mcp-server-mysql" 错误,可能需要显式设置所有必需二进制文件的路径,包括 npxnode 的路径。

使用教程

使用依赖

  • 需要安装 NodeJS 和 npm。

安装教程

  1. 确保已安装 NodeJS 和 npm。
  2. 使用以下命令安装 mcp-server-mysql: bash npx -y @benborla29/mcp-server-mysql
  3. 配置环境变量 MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASS, MYSQL_DB 以连接到 MySQL 数据库。

调试方式

  1. 确保所有环境变量已正确设置。
  2. 如果遇到连接问题,检查 PATH 环境变量是否包含 NodeJS 和 npm 的路径。
  3. 使用以下配置示例进行调试: json { "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" } } } }

许可证

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