星战科技xingzhan.cloud
返回市场
dbeaver-mcp-服务器

dbeaver-mcp-服务器

作者：srthkdev20 星标更新：2025-11-10
安装使用来源：spider==github.com

项目介绍

DBeaver MCP 服务器

一款生产就绪的模型上下文协议（MCP）服务器，无缝集成到 DBeaver 中，通过您现有的 DBeaver 连接提供对 200 多种数据库类型的通用访问。专为与 Claude、Cursor 和其他兼容 MCP 的 AI 助手一起使用而设计。

npm 版本 许可证：MIT Node.js 下载量 GitHub 星标

<a href="https://glama.ai/mcp/servers/@srthkdev/dbeaver-mcp-server"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=880334884,2110859251&fm=3081&app=3081&f=PNG?w=760&h=400" alt="DBeaver Server MCP 服务器" /> </a>

🚀 主要特性

🔗 通用数据库连接性

  • 200+ 数据库类型：PostgreSQL、MySQL、Oracle、SQL Server、SQLite、MongoDB 等
  • 零配置：利用您现有的 DBeaver 连接
  • 自动检测：自动发现并连接到您的 DBeaver 工作区
  • 跨平台支持：Windows、macOS 和 Linux

🛡️ 企业级安全与保障

  • 凭证管理：使用 DBeaver 的安全凭证存储
  • 查询验证：内置保护防止危险操作
  • 确认提示：破坏性操作需要明确确认
  • 连接验证：在操作之前验证所有连接
  • 错误处理：全面的错误恢复和日志记录

📊 高级数据操作

  • 读取操作：带有自动 LIMIT 保护的安全 SELECT 查询
  • 写入操作：带有验证的 INSERT、UPDATE、DELETE 操作
  • 模式管理：完整的 DDL 操作（CREATE、ALTER、DROP）
  • 数据导出：CSV、JSON、XML、Excel 导出格式
  • 性能监控：查询执行时间跟踪

🧠 AI 驱动智能

  • 业务洞察：通过标签跟踪和存储分析见解
  • 资源浏览：通过 MCP 资源浏览表模式
  • 智能建议：上下文感知的数据库推荐
  • 分析跟踪：持久存储商业智能发现

🔧 开发者体验

  • MCP 协议：完全符合 Model Context Protocol
  • TypeScript：完整的类型安全和 IntelliSense 支持
  • 调试模式：全面的日志记录和故障排除
  • 版本兼容性：支持 DBeaver 6.x 到 21.x+

🔧 版本兼容性

此 MCP 服务器会自动检测并支持两种 DBeaver 配置格式：

  • 旧版 DBeaver (6.x)：使用 .metadata/.plugins/org.jkiss.dbeaver.core/ 中基于 XML 的配置
  • 新版 DBeaver (21.x+)：使用 General/.dbeaver/ 中基于 JSON 的配置

服务器会自动检测您的 DBeaver 版本，并使用适当的配置解析器。

🛠️ 可用工具

📋 连接管理

工具描述安全级别
list_connections列出所有 DBeaver 数据库连接✅ 安全
get_connection_info获取详细的连接信息✅ 安全
test_connection测试数据库连接性✅ 安全

📊 数据操作

工具描述安全级别
execute_query执行 SELECT 查询（只读）✅ 安全
write_query执行 INSERT、UPDATE、DELETE 查询⚠️ 修改数据
export_data将查询结果导出为 CSV/JSON/XML/Excel✅ 安全

🏗️ 模式管理

工具描述安全级别
list_tables列出数据库中的所有表和视图✅ 安全
get_table_schema获取详细的表模式信息✅ 安全
create_table创建新的数据库表⚠️ 模式更改
alter_table修改现有表模式⚠️ 模式更改
drop_table删除表（需要确认）❌ 破坏性

📈 分析与智能

工具描述安全级别
get_database_stats获取数据库统计信息和信息✅ 安全
append_insight向备忘录添加业务洞察✅ 安全
list_insights列出存储的业务洞察✅ 安全

📋 先决条件

  • Node.js 18+
  • 已安装并配置了至少一个连接的 DBeaver
  • Claude Desktop、Cursor 或其他兼容 MCP 的客户端

🛠️ 安装

快速安装（推荐）

npm install -g dbeaver-mcp-server

验证安装

dbeaver-mcp-server --help

手动安装

git clone https://github.com/srthkdev/dbeaver-mcp-server.git
cd dbeaver-mcp-server
npm install
npm run build
npm link  # 使命令全局可用

🖥️ 配置

Claude Desktop 配置

{
  "mcpServers": {
    "dbeaver": {
      "command": "dbeaver-mcp-server",
      "env": {
        "DBEAVER_DEBUG": "false",
        "DBEAVER_TIMEOUT": "30000"
      }
    }
  }
}

环境变量

  • DBEAVER_PATH：DBeaver 可执行文件的路径（未设置时自动检测）
  • DBEAVER_TIMEOUT：查询超时时间（毫秒，默认值：30000）
  • DBEAVER_DEBUG：启用调试日志（true/false）

💡 快速入门示例

🔍 基本数据库操作

# 列出所有数据库连接
"显示我所有的数据库连接"

# 执行简单查询
"在我的 PostgreSQL 数据库上运行这个查询：
SELECT COUNT(*) FROM orders WHERE date > '2024-01-01'"

# 获取表模式信息
"我的 MySQL 数据库中 users 表的模式是什么？"

# 导出数据进行分析
"从我的 Oracle 数据库导出所有客户数据到 CSV"

🏗️ 模式管理

# 创建新表
"创建一个名为 'products' 的新表，包含 id、name、price、created_at 列"

# 修改现有表
"向 products 表添加一个 'description' 列"

# 安全删除表（需要确认）
"我想删除 test_table - 确保先确认"

📊 商业智能与分析

# 带有洞察的数据分析
"找出按订单价值排名前十的客户，并保存这个洞察"

# 跟踪业务发现
"第四季度销售数据显示移动订单增加了 23% - 标记为 'quarterly-analysis'"

# 查看过去的分析
"显示所有与销售表现相关的洞察"

🔧 高级用例

# 性能分析
"分析生产数据库中的查询性能并识别慢查询"

# 数据质量检查
"检查客户表中是否存在缺失或无效数据"

# 迁移规划
"帮助我分析当前模式以从 MySQL 迁移到 PostgreSQL"

🔧 资源浏览

服务器提供了 MCP 资源用于浏览数据库模式：

  • 直接在您的 MCP 客户端中浏览表模式
  • 资源自动从您的 DBeaver 连接中发现
  • 提供结构化的模式信息，格式为 JSON

🛡️ 安全特性

  • 查询验证：自动检测危险操作
  • 确认要求：破坏性操作需要明确确认
  • 连接验证：在操作之前验证所有连接
  • 错误处理：全面的错误消息和日志记录
  • 速率限制：内置超时以防止失控查询

🚀 生产特性

  • 全面日志记录：调试模式用于故障排除
  • 错误恢复：优雅地处理连接失败
  • 性能监控：查询执行时间跟踪
  • 业务上下文：数据分析工作流中的洞察跟踪
  • 多格式导出：支持 CSV 和 JSON 导出格式

🛠️ 开发

设置开发环境

git clone https://github.com/srthkdev/dbeaver-mcp-server.git
cd dbeaver-mcp-server
npm install

可用脚本

npm run build          # 构建项目
npm run dev            # 开发模式监视
npm run clean          # 清理构建产物
npm run start          # 启动服务器
npm run test           # 运行测试（占位符）
npm run lint           # 运行代码检查（占位符）

发布到 npm

npm run publish        # 交互式发布脚本
npm run publish:patch  # 快速补丁版本（1.1.3 → 1.1.4）
npm run publish:minor  # 快速次要版本（1.1.3 → 1.2.0）
npm run publish:major  # 快速主要版本（1.1.3 → 2.0.0）

构建脚本

  • scripts/build.sh：构建项目
  • scripts/install.sh：安装依赖并构建
  • scripts/publish.sh：带检查的 npm 发布

📝 文档

🆚 为什么选择 DBeaver MCP 服务器？

🏆 行业领先特性

特性DBeaver MCP其他 MCP 服务器
数据库支持200+ 数据库4-5 数据库
配置零配置（使用现有 DBeaver）需要手动设置
模式浏览✅ MCP 资源❌ 有限
商业智能✅ 洞察跟踪❌ 不可用
DDL 操作✅ 完整（CREATE、ALTER、DROP）⚠️ 有限
安全特性✅ 高级验证⚠️ 基础
导出格式✅ CSV、JSON、XML、Excel⚠️ 有限
错误处理✅ 生产就绪⚠️ 基础
跨平台✅ Windows、macOS、Linux⚠️ 有限

🎯 适合人群

  • 数据分析师：全面的数据库访问，带有 AI 辅助
  • 数据库管理员：完整的模式管理和监控
  • 开发者：与现有 DBeaver 工作流程无缝集成
  • 商业智能：高级分析，带有洞察跟踪
  • 企业团队：生产就绪，带有企业级安全特性

🤝 贡献

  1. 分叉仓库
  2. 创建功能分支：git checkout -b feature/new-feature
  3. 进行更改并添加测试（如果适用）
  4. 提交更改：git commit -m '添加新功能'
  5. 推送到分支：git push origin feature/new-feature
  6. 提交拉取请求

📦 NPM 包

此项目作为 dbeaver-mcp-server 发布在 npm 上：

npm 包 npm 下载量

📝 许可证

MIT 许可证 - 详情见 LICENSE 文件

🙏 致谢

  • Anthropic 提供的 Model Context Protocol
  • DBeaver 提供的出色数据库工具
  • 开源社区提供的灵感和反馈

注意：此项目不是官方与 DBeaver 或 Anthropic 的合作。它旨在与 AI 助手一起用于实际生产用途。