
@davewind/mysql-mcp-server

2025.05.08
0
JavaScript数据库中间件只读访问模式发现数据库
dave-wind_mysql-mcp-server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 MySQL 数据库的只读访问。该服务允许大型语言模型 (LLMs) 检查数据库结构并执行只读查询。其主要功能包括只读数据库访问、模式发现、SQL 查询执行以及符合 MCP 规范的集成。
View on GitHub
Overview
基本能力
产品定位
dave-wind_mysql-mcp-server 是一个数据库中间件服务,专门为大型语言模型 (LLMs) 提供对 MySQL 数据库的只读访问能力。
核心功能
- 只读数据库访问:通过 SQL 验证和 READ ONLY 事务强制执行只读操作。
- 模式发现:自动识别并暴露数据库表结构。
- SQL 查询执行:提供查询工具,接受并执行 SELECT 语句。
- Model Context Protocol 合规性:实现 MCP 规范,与兼容的 LLMs 无缝集成。
- 简单配置:设置简单,所需配置最少。
适用场景
- 需要让 LLMs 访问 MySQL 数据库但不允许修改数据的场景。
- 需要自动发现数据库模式并暴露给 LLMs 的场景。
- 需要执行只读 SQL 查询的场景。
工具列表
- query
- 对连接的数据库执行只读 SQL 查询。
- 输入:
sql
(字符串):要执行的 SQL 查询。 - 所有查询都在 READ ONLY 事务中执行。
常见问题解答
- 如何确保数据库访问是只读的?
- 通过 SQL 查询验证仅允许 SELECT 语句。
- 所有查询都在 READ ONLY 事务中执行。
- 不支持数据修改操作(INSERT, UPDATE, DELETE 等)。
- 不支持数据库模式修改(CREATE, ALTER, DROP 等)。
使用教程
使用依赖
- Node.js v18 或更高版本。
安装教程
npm install @davewind/mysql-mcp-server -g
配置
MCP 设置配置文件示例:
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": ["-y", "@davewind/mysql-mcp-server", "mysql://user:password@localhost:port/database"]
}
}
}
调试方式
替换 mysql://user:password@localhost:port/
并运行:
"scripts": {
"inspector": "npx @modelcontextprotocol/[email protected] build/index.js mysql://user:password@localhost:port/database"
}