Overview
What is mcp-mysql-server?
一个基于 Model Context Protocol 的 MySQL 数据库操作服务器,使 AI 模型能够通过标准化接口与 MySQL 数据库进行交互。
How to use mcp-mysql-server?
支持两种部署模式:在 MCP 配置文件中的本地模式通过 npx 运行并设置环境变量(MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE、MYSQL_PORT 可选),或远程 URL 模式指定服务器地址。服务器启动后提供 connect_db、query、list_tables、describe_table 等工具。
Key features of mcp-mysql-server
- 安全的连接处理,自动清理
- 支持预处理语句防止 SQL 注入
- 多用户并发支持与连接池(最多50连接)
- 自动连接管理与优雅容错
- 支持 URL 远程模式,凭据不暴露客户端
- TypeScript 支持,详细请求跟踪
Use cases of mcp-mysql-server
- AI 模型通过标准化接口安全查询 MySQL 数据库
- 列出数据库所有表并获取表结构信息
- 使用预处理语句执行带参数的 SELECT 查询
- 多用户同时操作同一数据库,互不干扰
- 远程部署数据库操作服务,保护敏感凭据
FAQ from mcp-mysql-server
如何配置数据库连接?
通过环境变量设置 MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE,MYSQL_PORT 可选(默认 3306);也可在运行时通过 connect_db 工具传入参数。
支持哪些数据库操作?
提供 connect_db、query(执行 SELECT 查询)、list_tables(列出所有表)、describe_table(获取表结构)四个工具。
性能上有什么限制?
支持最多 50 个并发连接(可配置),连接池自动管理以提高资源利用率。
如何防止 SQL 注入?
使用预处理语句,执行前验证查询,并在完成后自动关闭连接。
版本 v0.2.4+ 有哪些改进?
新增多用户并发支持、高效连接池管理、请求级别隔离、详细日志记录、改进的错误处理和性能优化。