MySQL 导航器 MCP

一个强大的 MySQL/MariaDB 数据库导航工具，使用 MCP（模型控制协议），可轻松进行数据库查询和管理。

特征

连接到 MySQL/MariaDB 数据库
动态切换不同的数据库
使用类型安全执行 SQL 查询
检索数据库架构信息
查询参数的 Pydantic 模型验证
安全凭证管理
综合测井系统
连接池和重试机制
SSL/TLS 支持安全连接

Related MCP server: MarineTraffic MCP Server

日志文件位置（跨平台）

默认情况下，所有日志都写入：

Windows： C:\Users\<YourUsername>\.mcp\mcp-db.log
macOS/Linux： /home/<yourusername>/.mcp/mcp-db.log /mcp-db.log 或/Users/<yourusername>/.mcp/mcp-db.log mcp-db.log

如果您的主目录中不存在.mcp文件夹，应用程序将自动创建该文件夹。如果遇到任何问题，您可以手动创建该文件夹：

视窗：

mkdir $env:USERPROFILE\.mcp

macOS/Linux：

mkdir -p ~/.mcp

安装

来自 PyPI（推荐给大多数用户）：

pip install mcp-db-navigator

来自源代码（用于开发）：

git clone <your-repo-url> cd mcp-db pip install -e .

使用您的数据库凭证创建一个.env文件：

DB_HOST=your_host DB_PORT=your_port DB_NAME=your_database_name DB_USER=your_username DB_PASSWORD=your_password DB_SSL_CA=/path/to/ssl/ca.pem # Optional: for SSL/TLS connections DB_MAX_RETRIES=3 # Optional: number of connection retries DB_RETRY_DELAY=1.0 # Optional: delay between retries in seconds

使用示例

1.命令行

直接从终端运行 MCP 服务器：

mcp-db --config /path/to/your/project/.env

2. 在光标处

要在Cursor中使用此 MCP 服务器：

打开 Cursor 设置并添加一个新的 MCP 服务器。
使用以下配置（示例）：

{ "mcpServers": { "mysql-navigator": { "command": "mcp-db", "args": [ "--config", "/absolute/path/to/your/.env" ] } } }

确保.env文件的路径是绝对的。

3.在Claude桌面

如果 Claude Desktop 支持 MCP 服务器：

添加一个新的 MCP 服务器，并使用上面的--config参数将其指向mcp-db命令。
有关添加自定义 MCP 服务器的详细信息，请参阅 Claude Desktop 的文档。

查询参数

查询字典支持以下参数：

table_name （必填）：要查询的表的名称
select_fields （可选）：要选择的字段列表（默认为[“*”]）
where_conditions （可选）：WHERE 子句的字段值对字典
order_by （可选）：排序依据的字段列表
order_direction （可选）：排序方向“ASC”或“DESC”（默认值：“ASC”）
limit （可选）：要返回的记录数
offset （可选）：要跳过的记录数
group_by （可选）：分组依据的字段列表
having （可选）：HAVING 子句的字段值对字典
join_table （可选）：要连接的表的名称
join_type （可选）：JOIN 操作的类型（默认值：“INNER”）
join_conditions （可选）：连接条件字典

安全功能

数据库凭证通过配置文件管理
密码在 Pydantic 模型中存储为 SecretStr
所有查询参数的输入验证
通过参数化查询预防 SQL 注入
SSL/TLS 加密连接支持
连接字符串清理
查询速率限制
查询参数清理

生产特点

错误处理

全面的数据库操作错误处理
连接超时处理
失败连接的自动重试机制
所有参数的输入验证

表现

连接池以实现最佳资源利用
查询执行时间记录
连接池统计信息
性能指标收集

监控

具有不同日志级别的结构化日志记录
查询执行跟踪
连接状态监控
错误率追踪

贡献

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

MySQL Navigator MCP