
MCP Server for MySQL based on NodeJS

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" 错误,可能需要显式设置所有必需二进制文件的路径,包括
npx
和node
的路径。
使用教程
使用依赖
- 需要安装 NodeJS 和 npm。
安装教程
- 确保已安装 NodeJS 和 npm。
- 使用以下命令安装 mcp-server-mysql:
bash npx -y @benborla29/mcp-server-mysql
- 配置环境变量
MYSQL_HOST
,MYSQL_PORT
,MYSQL_USER
,MYSQL_PASS
,MYSQL_DB
以连接到 MySQL 数据库。
调试方式
- 确保所有环境变量已正确设置。
- 如果遇到连接问题,检查
PATH
环境变量是否包含 NodeJS 和 npm 的路径。 - 使用以下配置示例进行调试:
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" } } } }