MCP数据库工具

<!-- 项目状态徽章 -->

<!-- 版本和安装徽章 -->

<!-- 技术规格徽章 -->

English | French | English | Arabic | Russian | 文档导航

简介

MCP数据库实用工具是一个多功能的MCP服务，它允许您的AI通过统一的连接配置安全地访问各种类型的数据库（如SQLite、MySQL、PostgreSQL等）进行数据分析。

您可以将其视为AI系统与数据库之间的安全桥梁，使AI能够读取并分析您的数据，而无需直接访问数据库或冒着数据被修改的风险。

核心特性

• 安全性优先严格的只读操作，无直接数据库访问，隔离连接，按需连接，自动超时
• 隐私保护本地处理，最小的数据暴露，凭证保护，敏感数据屏蔽
• 多数据库支持使用相同的接口连接SQLite、MySQL和PostgreSQL
• 简单配置所有数据库连接使用一个YAML文件
• 高级功能表浏览、架构分析和查询执行

🔒 安全须知MCP数据库工具采用安全第一的架构设计，非常适合注重数据保护的企业、初创公司和个人用户。详细了解我们的安全架构。

快速开始

我们提供了多种安装方法，包括UVX、Docker和Smithery。详细的安装和配置步骤，请参阅安装指南。

步骤

1. 安装选择适合您的安装方法（详细描述）
2. 配置创建包含数据库连接信息的YAML文件（配置指南）
3. 连接在您的AI客户端中添加配置
4. 使用：开始与您的数据库交互（用户指南）

示例交互

您能否列出我数据库中的所有表？

AI这是您数据库中的表：

• 客户
• 产品
• 订单
• 库存

您客户表的结构是什么？

AI客户表具有以下结构：

• ID（整数，主键）
• 名字（文本）
• 邮件（文本）
• 注册日期（日期）

文档导航

入门指南

• 安装指南 -详细的安装步骤和配置说明
• 特定平台安装指南 -不同操作系统下的安装说明
• 配置指南 -数据库连接配置示例和最佳实践
• 用户指南 -基本操作流程和常见使用场景

技术文档

• 架构设计 -系统架构和组件描述
• 安全架构 -安全特性和保护机制
• 开发指南 -代码质量和开发过程
• 测试指南 -测试框架和最佳实践
• SonarCloud集成 -SonarCloud和AI集成指南

示例文档

• SQLite 示例 -SQLite数据库操作示例
• PostgreSQL 示例 -PostgreSQL数据库操作示例
• MySQL 示例 -MySQL数据库操作示例
• 高级LLM交互示例 -与各种LLM的高级交互示例

多语言文档

• 英语 - 英文文档
• 法语 - 法文文档
• 西班牙语 - 西班牙语文档
• 阿拉伯语 - 阿拉伯语文档
• 俄语 - 俄语文档

支持与反馈

• GitHub Issues -报告问题或请求功能
• Smithery -简化安装和更新

可用工具

MCP数据库工具提供多个工具，使AI能够与您的数据库进行交互：

• dbutils-list-connections列出配置中所有可用的数据库连接，包括数据库类型、主机、端口和数据库名称等详细信息，同时隐藏密码等敏感信息。
• dbutils-list-tables列出指定数据库连接中的所有表，包括表名、URI和可用的表描述，按数据库类型分组以便于识别。
• dbutils-run-query执行只读SQL查询（仅限SELECT），支持复杂的查询，包括JOIN、GROUP BY和聚合函数，并返回包含列名和数据行的结构化结果。
• dbutils-describe-table提供关于表结构的详细信息，包括列名、数据类型、是否可为空、默认值和注释，以易于阅读的格式呈现。
• dbutils-get-ddl获取创建指定表的完整DDL（数据定义语言）语句，包括所有列定义、约束和索引。
• dbutils-list-indexes列出指定表上的所有索引，包括索引名称、类型（唯一/非唯一）、索引方法和包含的列，按索引名称分组。
• dbutils-get-stats获取表的统计信息，包括估计的行数、平均行长度、数据大小和索引大小。
• dbutils-list-constraints列出表上的所有约束，包括主键、外键、唯一约束和检查约束。对于外键约束，还显示引用的表和列。
• dbutils-explain-query获取SQL查询的执行计划，展示数据库引擎将如何处理这些查询，包括访问方法、连接类型和估计成本。
• dbutils-get-performance获取数据库连接的性能指标，包括查询次数、平均执行时间、内存使用情况和错误统计。
• dbutils-analyze-query分析SQL查询的性能特征，提供执行计划、实际执行时间和具体的优化建议。

有关这些工具的详细说明和使用示例，请参阅用户指南。

星标历史

许可证

该项目采用MIT许可证 - 更多信息，请参阅LICENSE文档。