用途:db-mcp-server 基于 FreePeak/cortex 框架实现 Model Context Protocol(MCP),为 AI 助手提供同时访问多个数据库的统一接口,可执行 SQL 查询、管理事务、探索模式并分析性能。
主要能力:支持同时连接多个 MySQL、PostgreSQL、SQLite、Oracle 数据库;为每个已连接数据库自动生成专用工具;支持 --lazy-loading 延迟连接;提供统一工具模式(--unified-tools),注册 query、execute、transaction、performance、explain、describe、schema、filter_tables 等合并工具,适合连接 5 个以上数据库时降低工具数量与上下文开销;对安装 timescaledb 扩展的 PostgreSQL 自动注册 TimescaleDB 专用工具。
使用方式:源码安装后创建 config.json 配置数据库连接,schema_version: 1 启用严格字段校验;凭据建议使用环境变量名或挂载的密钥文件,而非直接写入 JSON。命令行选项包括 -t/-transport(stdio、legacy sse、experimental streamable)、-c/-config、-p/-port(默认 9092)、-h/-host(默认 127.0.0.1)、--version、-allow-insecure-sse、-api-key、-log-level、-log-dir、-db-config、-lazy-loading、-unified-tools。更新命令为 db-mcp-server update,-check 仅检查,-force 重装当前版本。
适用场景与限制:最安全的本地集成方式是 STDIO,HTTP 传输仍在加固中,不应直接暴露到共享网络;legacy SSE 无内置认证,默认禁用,仅可在受信任私有反向代理后显式启用;实验性 Streamable HTTP 需要 DB_MCP_API_KEY,并建议置于私有 TLS 网关后。生产防护包括按数据库的 read_only 强制、max_rows 截断与每查询超时,以及 DB_MCP_AUDIT_LOG 审计日志。Docker 镜像为开发/演示用途,不适合公开部署。