适合谁
- 需要在多个 AI 平台和 IDE 中使用自然语言访问数据库的开发者和数据分析师
- 需要连接多种数据库（包括国产数据库）的场景
- 希望提供只读安全访问、避免误操作的环境
U
49FMRS · D
Universal DB MCP 是一个功能强大的数据库 MCP 连接器，支持广泛的数据库和平台，提供灵活的架构和多种权限控制，但需要用户注意安全配置和权限管理。
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 支持、数据脱敏等功能。
工具能力
execute_query
执行只读 SQL 查询并返回结果。
get_schema
获取数据库的结构信息，包括表、列、索引等。
get_table_info
获取指定表的详细信息，如列、类型、注释等。
clear_cache
清除缓存的数据库 schema 信息。
get_enum_values
获取枚举类型列的允许值列表。
get_sample_data
获取指定表的示例数据。
connect_database
连接一个新的数据库实例。
disconnect_database
断开当前数据库连接。
get_connection_status
检查当前数据库连接的状态。
安装接入
全局安装：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"
]
}
}
}
选型与风险
不适合谁
- 需要执行写操作（如 INSERT、UPDATE、DELETE）且不希望受权限限制的场景（默认只读）
- 对数据库连接安全性有特殊要求，不希望使用第三方连接器的场景
所需权限
- 读取数据库连接配置信息
- 执行 SQL 查询（默认只读模式，可通过配置增加写权限）
- 访问数据库 schema 和元数据
风险与副作用
- 如果开启写权限（full 模式），可能导致数据损坏或丢失
- 数据库凭据可能以明文形式存储在配置文件中，需妥善保管
- 远程访问（HTTP）可能面临未授权访问风险，需使用 API 密钥和网络安全措施
常见排障
- 确保 Node.js 版本 >= 20.0.0
- 检查 MCP 配置中的数据库连接参数是否正确
- 如果连接失败，检查数据库是否允许远程连接、防火墙是否开放
- 查看日志（通过 --debug 或环境变量）获取更多错误信息
使用场景
直接询问 AI 助手数据库相关问题，如“显示上个月订单价值前十的客户”
在 Claude Desktop、Cursor、Windsurf 等 IDE 中通过自然语言查询和分析数据库数据
通过 REST API 集成到 Coze、n8n 等自动化平台
支持客户端
Claude Desktop完整支持
Cursor完整支持
Windsurf完整支持
VS Code完整支持
ChatGPT部分支持