@davewind/mysql-mcp-server

一个提供对MySQL数据库只读访问的Model Context Protocol服务器。该服务器使LLM能够检查数据库模式并执行只读查询。

主要特性

1. 只读数据库访问：通过SQL验证和只读事务强制执行只读操作
2. 模式发现：自动识别并公开数据库表结构
3. SQL查询执行：提供一个查询工具，接受并执行SELECT语句
4. Model Context Protocol合规性：实现MCP规范，以便与兼容的LLM无缝集成
5. 简单配置：设置简单，所需配置最少

工具

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

资源

服务器为数据库中的每个表提供模式信息：

• 表模式 (mysql://user:password@localhost:3306/database)
  • 每个表的JSON模式信息
  • 包括列名和数据类型
  • 从数据库元数据中自动发现

安装

bash
npm install @davewind/mysql-mcp-server -g

配置

MCP设置配置文件：

推荐使用

json
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": ["-y", "@davewind/mysql-mcp-server", "mysql://user:password@localhost:port/database"],
}
}
}

测试

替换 mysql://user:password@localhost:port/ 并运行 npm run inspector
js
"scripts": {
"inspector": "npx @modelcontextprotocol/inspector@0.10.2 build/index.js mysql://user:password@localhost:port/database
}

环境

js
node v18 +

系统架构

MySQL MCP Server作为LLM和MySQL数据库之间的中介，根据Model Context Protocol处理请求。

组件交互

组件交互

安全模型

MySQL MCP Server实现了一个严格的安全模型，以确保数据库访问是只读的。

安全措施包括：

1. SQL查询验证，仅允许SELECT语句
2. 在只读事务中执行所有查询
3. 不支持数据修改操作（INSERT, UPDATE, DELETE等）
4. 不支持数据库模式修改（CREATE, ALTER, DROP等）

与LLM的集成

MySQL MCP Server设计为与任何支持Model Context Protocol的LLM系统一起工作。它通过遵循MCP规范的stdio上的JSON-RPC进行通信。

许可证

MIT