← 返回目录

Universal DB MCP

社区

用自然语言连接 AI 与数据库的通用 MCP 连接器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 数据库第 41 / 58
Stars: ★ 940 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js >=20.0.0 · Docker
凭据: 无需凭据
许可证: MIT
最近提交: 7 个月前 ⚠
工具数: 9

49FMRS · D

Universal DB MCP 是一个功能强大的数据库 MCP 连接器，支持广泛的数据库和平台，提供灵活的架构和多种权限控制，但需要用户注意安全配置和权限管理。

最强项 · 文档质量 13/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

9/20

维护活跃度

10/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: README 内部自洽：stdio 与 HTTP 模式下列出相同的 9 个工具，三种 MCP 传输方式加 REST API 的描述一致，纸面上没有明显矛盾。但本次评审未获得任何源码、package manifest、测试或 CI 工作流，无法验证声明工具真实存在或其行为与文档匹配；README 声称的缓存提速（最高 100 倍）只是不可核实的数据。按静态校准，缺少可验证的执行证据时可靠性不得高于 12，且缺失证据应扣分而非按最好情况假设，因此给分贴近下限。
安全与权限 9/20: 未触发红线：所有安装示例均使用占位符（your_password、xxx、your-secret-key），没有真实令牌；默认 safe 只读模式明示阻止 INSERT/UPDATE/DELETE/DROP 等写操作，危险的 full 模式需要显式参数开启。README 记录了权限模式、权限类型、数据脱敏、不同传输方式下的权限参数命名以及安全最佳实践，体现了 least-privilege 的设计意图。扣分原因：没有源码可以验证写操作拦截、SQL 解析和脱敏逻辑是否真的生效；SSE 示例把数据库密码放在 URL query string 中，存在经访问日志、代理或浏览器历史泄露的风险；full/readwrite 模式未提及破坏性操作的二次确认；没有行级/列级数据边界或审计日志的证据；远程传输未说明强制 TLS。
维护活跃度 10/20: 项目带有 MIT 许可证，仓库未标记为 archived，npm 版本与下载徽章表明存在已发布版本，文档中引用了 CHANGELOG。扣分：未提供发布日期、提交历史或 issue 响应时效的证据；没有安全策略（SECURITY.md）或漏洞报告渠道；依赖更新和 CI 状态无法确认。900 星属于发现信号，按证据规则不计入分数。整体属于活跃但治理与版本发布证据有缺口的状态。
文档质量 13/20: README 分层且具体：安装命令、Claude Desktop 完整 JSON 配置、HTTP 模式环境变量、带请求头的端点表、17 种数据库类型与默认端口表、权限模式与传输方式参数对照表、55+ 平台集成指南，以及覆盖部署、安全、多租户、架构、故障排查的文档目录，示例充足。扣分：README 未给出每个 MCP 工具的参数 schema（仅指向未提供的文档文件）；未披露限制（如查询超时、结果集大小上限）和成本；引用的 docs 文件在本次素材中不可见，README 本身属不可信证据，因此文档深度无法核实。
安装易用性 12/20: 纸面上安装步骤清晰简短：npm install -g universal-db-mcp，将给出的 JSON 粘贴到 claude_desktop_config.json 并重启客户端即可使用；HTTP 模式只需设置两个环境变量并通过 curl 健康检查验证；SSE 与 Streamable HTTP 的连接示例齐全，覆盖多种主流客户端。扣分：按静态校准，缺少提交的 CI 与测试时 setup 最高不超过 15，而本次没有任何执行证据；17 种数据库驱动（尤其 Oracle、SQL Server 原生客户端）的依赖体积可能使实际安装脆弱；没有可审查的 package.json/bin 入口来确认 npx universal-db-mcp 命令可解析。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

需要在多个 AI 平台和 IDE 中使用自然语言访问数据库的开发者和数据分析师
需要连接多种数据库（包括国产数据库）的场景
希望提供只读安全访问、避免误操作的环境

不适合谁

需要执行写操作（如 INSERT、UPDATE、DELETE）且不希望受权限限制的场景（默认只读）
对数据库连接安全性有特殊要求，不希望使用第三方连接器的场景

所需权限

读取数据库连接配置信息
执行 SQL 查询（默认只读模式，可通过配置增加写权限）
访问数据库 schema 和元数据

风险与副作用

如果开启写权限（full 模式），可能导致数据损坏或丢失
数据库凭据可能以明文形式存储在配置文件中，需妥善保管
远程访问（HTTP）可能面临未授权访问风险，需使用 API 密钥和网络安全措施

安装接入

准备工作

运行环境：Node.js >=20.0.0 · Docker

API_KEYS 可选密钥 HTTP API 模式的访问密钥，由用户自行设置的私密字符串，用于鉴权。

其他可选配置项（2 个）

MODE 可选启动模式，设为 http 时启用 HTTP API/SSE 模式（默认 stdio）。

HTTP_PORT 可选 HTTP 模式下服务监听的端口号，示例中为 3000。

全局安装：npm install -g universal-db-mcp

对于 Claude Desktop，编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json），添加 mcpServers 配置，然后重启 Claude Desktop。

对于 HTTP 模式：设置环境变量 MODE=http, HTTP_PORT=3000, API_KEYS=your-secret-key，然后运行 npx universal-db-mcp。

claude_desktop_config.json

{
  "mcpServers": {
    "my-database": {
      "command": "npx",
      "args": [
        "universal-db-mcp",
        "--type", "mysql",
        "--host", "localhost",
        "--port", "3306",
        "--user", "root",
        "--password", "your_password",
        "--database", "your_database"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "my-database": {
      "command": "npx",
      "args": [
        "universal-db-mcp",
        "--type",
        "mysql",
        "--host",
        "localhost",
        "--port",
        "3306",
        "--user",
        "root",
        "--password",
        "your_password",
        "--database",
        "your_database"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add my-database -- npx universal-db-mcp --type mysql --host localhost --port 3306 --user root --password your_password --database your_database

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

重启 Claude Desktop 后，在工具列表中应能看到 execute_query、get_schema、get_table_info 等工具；用“统计最近 7 天的订单数量”这类提问并返回结果即证明连接成功。

常见排障

确保 Node.js 版本 >= 20.0.0
检查 MCP 配置中的数据库连接参数是否正确
如果连接失败，检查数据库是否允许远程连接、防火墙是否开放
查看日志（通过 --debug 或环境变量）获取更多错误信息

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查看 users 表的结构
统计最近 7 天的订单数量
按销售额排序，找出前 5 个产品
查看 connection_status 里当前的数据库连接状态

工具能力 9

execute_query 只读

执行只读 SQL 查询并返回结果。

get_schema 只读

获取数据库的结构信息，包括表、列、索引等。

get_table_info 只读

获取指定表的详细信息，如列、类型、注释等。

clear_cache 破坏性

清除缓存的数据库 schema 信息。

get_enum_values 只读

获取枚举类型列的允许值列表。

get_sample_data 只读

获取指定表的示例数据。

connect_database 写入

连接一个新的数据库实例。

disconnect_database 破坏性

断开当前数据库连接。

展开其余 1 个工具

get_connection_status 只读

检查当前数据库连接的状态。

使用场景

直接询问 AI 助手数据库相关问题，如“显示上个月订单价值前十的客户”

在 Claude Desktop、Cursor、Windsurf 等 IDE 中通过自然语言查询和分析数据库数据

通过 REST API 集成到 Coze、n8n 等自动化平台

支持客户端

Claude Desktop

Cursor

Windsurf

VS Code

ChatGPT部分支持

依据项目文档列出，未经本站实测。

详细介绍

Universal DB MCP 是一个基于 Model Context Protocol (MCP) 的通用数据库连接器，支持 MySQL、PostgreSQL、Oracle、MongoDB 等 17 种数据库，可通过自然语言进行数据查询和分析。它提供 2 种启动模式（stdio/http）和 4 种访问方式（MCP stdio、MCP SSE、MCP Streamable HTTP、REST API），兼容 Claude Desktop、Cursor、Windsurf、VS Code、ChatGPT 等 50+ 平台。默认以只读模式运行，支持多种权限模式、智能缓存、批量查询优化、多 Schema 支持、数据脱敏等功能。