mcp-dbutils 0.17.0__tar.gz → 0.19.0__tar.gz

{mcp_dbutils-0.17.0 → mcp_dbutils-0.19.0}/.gitignore

@@ -1,5 +1,5 @@
 # Python
-docs/
+docs/local/
 __pycache__/
 *.py[cod]
 *$py.class

{mcp_dbutils-0.17.0 → mcp_dbutils-0.19.0}/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [0.19.0](https://github.com/donghao1393/mcp-dbutils/compare/v0.18.0...v0.19.0) (2025-04-25)
+
+
+### Features
+
+* 完成多语言文档 ([#74](https://github.com/donghao1393/mcp-dbutils/issues/74)) ([aa5d7a6](https://github.com/donghao1393/mcp-dbutils/commit/aa5d7a6c4648bd575d538906d1dcd65ba5ba8c56))
+
+# [0.18.0](https://github.com/donghao1393/mcp-dbutils/compare/v0.17.0...v0.18.0) (2025-04-25)
+
+
+### Features
+
+* add dbutils-list-connections tool ([#68](https://github.com/donghao1393/mcp-dbutils/issues/68)) ([44ce9ac](https://github.com/donghao1393/mcp-dbutils/commit/44ce9ac9a63fcd43a0c817ee72b508380f36ba8d))
+
 # [0.17.0](https://github.com/donghao1393/mcp-dbutils/compare/v0.16.1...v0.17.0) (2025-03-16)
 
 

mcp_dbutils-0.19.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: mcp-dbutils
+Version: 0.19.0
+Summary: MCP Database Utilities Service
+Author: Dong Hao
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.2.1
+Requires-Dist: mysql-connector-python>=8.2.0
+Requires-Dist: psycopg2-binary>=2.9.10
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: pyyaml>=6.0.2
+Provides-Extra: test
+Requires-Dist: aiosqlite>=0.19.0; extra == 'test'
+Requires-Dist: docker>=7.0.0; extra == 'test'
+Requires-Dist: pre-commit>=3.6.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest-docker>=2.0.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: ruff>=0.3.0; extra == 'test'
+Requires-Dist: testcontainers>=3.7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# MCP 数据库工具
+
+<!-- 项目状态徽章 -->
+[![构建状态](https://img.shields.io/github/workflow/status/donghao1393/mcp-dbutils/Quality%20Assurance?label=tests)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![覆盖率](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/donghao1393/bdd0a63ec2a816539ff8c136ceb41e48/raw/coverage.json)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![质量门禁状态](https://sonarcloud.io/api/project_badges/measure?project=donghao1393_mcp-dbutils&metric=alert_status)](https://sonarcloud.io/dashboard?id=donghao1393_mcp-dbutils)
+
+<!-- 版本和安装徽章 -->
+[![PyPI 版本](https://img.shields.io/pypi/v/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![PyPI 下载量](https://img.shields.io/pypi/dm/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![Smithery](https://smithery.ai/badge/@donghao1393/mcp-dbutils)](https://smithery.ai/server/@donghao1393/mcp-dbutils)
+
+<!-- 技术规格徽章 -->
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![许可证](https://img.shields.io/github/license/donghao1393/mcp-dbutils)](LICENSE)
+[![GitHub 星标](https://img.shields.io/github/stars/donghao1393/mcp-dbutils?style=social)](https://github.com/donghao1393/mcp-dbutils/stargazers)
+
+[English](README_EN.md) | [Français](README_FR.md) | [Español](README_ES.md) | [العربية](README_AR.md) | [Русский](README_RU.md) | [文档导航](#文档导航)
+
+![Image](https://github.com/user-attachments/assets/26c4f1a1-7b19-4bdd-b9fd-34ad198b0ce3)
+
+## 简介
+
+MCP Database Utilities 是一个多功能的 MCP 服务，它使您的 AI 能够通过统一的连接配置安全地访问各种类型的数据库（SQLite、MySQL、PostgreSQL 等）进行数据分析。
+
+您可以将其视为 AI 系统和数据库之间的安全桥梁，允许 AI 在不直接访问数据库或冒数据修改风险的情况下读取和分析您的数据。
+
+### 核心特性
+
+- **安全优先**：严格只读操作，无直接数据库访问，隔离连接，按需连接，自动超时
+- **隐私保障**：本地处理，最小数据暴露，凭证保护，敏感数据屏蔽
+- **多数据库支持**：使用相同的接口连接 SQLite、MySQL、PostgreSQL
+- **简单配置**：所有数据库连接使用单个 YAML 文件
+- **高级功能**：表格浏览、架构分析和查询执行
+
+> 🔒 **安全说明**：MCP 数据库工具采用安全优先的架构设计，非常适合注重数据保护的企业、初创公司和个人用户。详细了解我们的[安全架构](docs/zh/technical/security.md)。
+
+## 快速入门
+
+我们提供了多种安装方式，包括 uvx、Docker 和 Smithery。详细的安装和配置步骤请参阅[安装指南](docs/zh/installation.md)。
+
+### 基本步骤
+
+1. **安装**：选择适合您的安装方式（[详细说明](docs/zh/installation.md)）
+2. **配置**：创建包含数据库连接信息的 YAML 文件（[配置指南](docs/zh/configuration.md)）
+3. **连接**：将配置添加到您的 AI 客户端
+4. **使用**：开始与您的数据库交互（[使用指南](docs/zh/usage.md)）
+
+### 示例交互
+
+**您**："能否列出我的数据库中的所有表？"
+
+**AI**："以下是您的数据库中的表：
+- customers（客户）
+- products（产品）
+- orders（订单）
+- inventory（库存）"
+
+**您**："customers 表的结构是什么样的？"
+
+**AI**："customers 表有以下结构：
+- id（整数，主键）
+- name（文本）
+- email（文本）
+- registration_date（日期）"
+
+## 文档导航
+
+### 入门指南
+- [安装指南](docs/zh/installation.md) - 详细的安装步骤和配置说明
+- [平台特定安装指南](docs/zh/installation-platform-specific.md) - 针对不同操作系统的安装说明
+- [配置指南](docs/zh/configuration.md) - 数据库连接配置示例和最佳实践
+- [使用指南](docs/zh/usage.md) - 基本操作流程和常见使用场景
+
+### 技术文档
+- [架构设计](docs/zh/technical/architecture.md) - 系统架构和组件说明
+- [安全架构](docs/zh/technical/security.md) - 安全特性和保护机制
+- [开发指南](docs/zh/technical/development.md) - 代码质量和开发流程
+- [测试指南](docs/zh/technical/testing.md) - 测试框架和最佳实践
+- [SonarCloud 集成](docs/zh/technical/sonarcloud-integration.md) - SonarCloud 与 AI 集成指南
+
+### 示例文档
+- [SQLite 示例](docs/zh/examples/sqlite-examples.md) - SQLite 数据库操作示例
+- [PostgreSQL 示例](docs/zh/examples/postgresql-examples.md) - PostgreSQL 数据库操作示例
+- [MySQL 示例](docs/zh/examples/mysql-examples.md) - MySQL 数据库操作示例
+- [高级 LLM 交互示例](docs/zh/examples/advanced-llm-interactions.md) - 与各类 LLM 的高级交互示例
+
+### 多语言文档
+- **英语** - [English Documentation](docs/en/)
+- **法语** - [Documentation Française](docs/fr/)
+- **西班牙语** - [Documentación en Español](docs/es/)
+- **阿拉伯语** - [التوثيق باللغة العربية](docs/ar/)
+- **俄语** - [Документация на русском](docs/ru/)
+
+### 支持与反馈
+- [GitHub Issues](https://github.com/donghao1393/mcp-dbutils/issues) - 报告问题或请求功能
+- [Smithery](https://smithery.ai/server/@donghao1393/mcp-dbutils) - 简化安装和更新
+
+## 可用工具
+
+MCP 数据库工具提供了多种工具，使 AI 能够与您的数据库交互：
+
+- **dbutils-list-connections**：列出配置中的所有可用数据库连接
+- **dbutils-list-tables**：列出数据库中的所有表
+- **dbutils-run-query**：执行 SQL 查询（仅 SELECT）
+- **dbutils-get-stats**：获取表统计信息
+- **dbutils-list-constraints**：列出表约束
+- **dbutils-explain-query**：获取查询执行计划
+- **dbutils-get-performance**：获取数据库性能指标
+- **dbutils-analyze-query**：分析查询以进行优化
+
+有关这些工具的详细说明和使用示例，请参阅[使用指南](docs/zh/usage.md)。
+
+## 星标历史
+
+[![星标历史图表](https://starchart.cc/donghao1393/mcp-dbutils.svg?variant=adaptive)](https://starchart.cc/donghao1393/mcp-dbutils)
+
+## 许可证
+
+本项目采用 MIT 许可证 - 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。

mcp_dbutils-0.19.0/README.md

@@ -0,0 +1,120 @@
+# MCP 数据库工具
+
+<!-- 项目状态徽章 -->
+[![构建状态](https://img.shields.io/github/workflow/status/donghao1393/mcp-dbutils/Quality%20Assurance?label=tests)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![覆盖率](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/donghao1393/bdd0a63ec2a816539ff8c136ceb41e48/raw/coverage.json)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![质量门禁状态](https://sonarcloud.io/api/project_badges/measure?project=donghao1393_mcp-dbutils&metric=alert_status)](https://sonarcloud.io/dashboard?id=donghao1393_mcp-dbutils)
+
+<!-- 版本和安装徽章 -->
+[![PyPI 版本](https://img.shields.io/pypi/v/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![PyPI 下载量](https://img.shields.io/pypi/dm/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![Smithery](https://smithery.ai/badge/@donghao1393/mcp-dbutils)](https://smithery.ai/server/@donghao1393/mcp-dbutils)
+
+<!-- 技术规格徽章 -->
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![许可证](https://img.shields.io/github/license/donghao1393/mcp-dbutils)](LICENSE)
+[![GitHub 星标](https://img.shields.io/github/stars/donghao1393/mcp-dbutils?style=social)](https://github.com/donghao1393/mcp-dbutils/stargazers)
+
+[English](README_EN.md) | [Français](README_FR.md) | [Español](README_ES.md) | [العربية](README_AR.md) | [Русский](README_RU.md) | [文档导航](#文档导航)
+
+![Image](https://github.com/user-attachments/assets/26c4f1a1-7b19-4bdd-b9fd-34ad198b0ce3)
+
+## 简介
+
+MCP Database Utilities 是一个多功能的 MCP 服务，它使您的 AI 能够通过统一的连接配置安全地访问各种类型的数据库（SQLite、MySQL、PostgreSQL 等）进行数据分析。
+
+您可以将其视为 AI 系统和数据库之间的安全桥梁，允许 AI 在不直接访问数据库或冒数据修改风险的情况下读取和分析您的数据。
+
+### 核心特性
+
+- **安全优先**：严格只读操作，无直接数据库访问，隔离连接，按需连接，自动超时
+- **隐私保障**：本地处理，最小数据暴露，凭证保护，敏感数据屏蔽
+- **多数据库支持**：使用相同的接口连接 SQLite、MySQL、PostgreSQL
+- **简单配置**：所有数据库连接使用单个 YAML 文件
+- **高级功能**：表格浏览、架构分析和查询执行
+
+> 🔒 **安全说明**：MCP 数据库工具采用安全优先的架构设计，非常适合注重数据保护的企业、初创公司和个人用户。详细了解我们的[安全架构](docs/zh/technical/security.md)。
+
+## 快速入门
+
+我们提供了多种安装方式，包括 uvx、Docker 和 Smithery。详细的安装和配置步骤请参阅[安装指南](docs/zh/installation.md)。
+
+### 基本步骤
+
+1. **安装**：选择适合您的安装方式（[详细说明](docs/zh/installation.md)）
+2. **配置**：创建包含数据库连接信息的 YAML 文件（[配置指南](docs/zh/configuration.md)）
+3. **连接**：将配置添加到您的 AI 客户端
+4. **使用**：开始与您的数据库交互（[使用指南](docs/zh/usage.md)）
+
+### 示例交互
+
+**您**："能否列出我的数据库中的所有表？"
+
+**AI**："以下是您的数据库中的表：
+- customers（客户）
+- products（产品）
+- orders（订单）
+- inventory（库存）"
+
+**您**："customers 表的结构是什么样的？"
+
+**AI**："customers 表有以下结构：
+- id（整数，主键）
+- name（文本）
+- email（文本）
+- registration_date（日期）"
+
+## 文档导航
+
+### 入门指南
+- [安装指南](docs/zh/installation.md) - 详细的安装步骤和配置说明
+- [平台特定安装指南](docs/zh/installation-platform-specific.md) - 针对不同操作系统的安装说明
+- [配置指南](docs/zh/configuration.md) - 数据库连接配置示例和最佳实践
+- [使用指南](docs/zh/usage.md) - 基本操作流程和常见使用场景
+
+### 技术文档
+- [架构设计](docs/zh/technical/architecture.md) - 系统架构和组件说明
+- [安全架构](docs/zh/technical/security.md) - 安全特性和保护机制
+- [开发指南](docs/zh/technical/development.md) - 代码质量和开发流程
+- [测试指南](docs/zh/technical/testing.md) - 测试框架和最佳实践
+- [SonarCloud 集成](docs/zh/technical/sonarcloud-integration.md) - SonarCloud 与 AI 集成指南
+
+### 示例文档
+- [SQLite 示例](docs/zh/examples/sqlite-examples.md) - SQLite 数据库操作示例
+- [PostgreSQL 示例](docs/zh/examples/postgresql-examples.md) - PostgreSQL 数据库操作示例
+- [MySQL 示例](docs/zh/examples/mysql-examples.md) - MySQL 数据库操作示例
+- [高级 LLM 交互示例](docs/zh/examples/advanced-llm-interactions.md) - 与各类 LLM 的高级交互示例
+
+### 多语言文档
+- **英语** - [English Documentation](docs/en/)
+- **法语** - [Documentation Française](docs/fr/)
+- **西班牙语** - [Documentación en Español](docs/es/)
+- **阿拉伯语** - [التوثيق باللغة العربية](docs/ar/)
+- **俄语** - [Документация на русском](docs/ru/)
+
+### 支持与反馈
+- [GitHub Issues](https://github.com/donghao1393/mcp-dbutils/issues) - 报告问题或请求功能
+- [Smithery](https://smithery.ai/server/@donghao1393/mcp-dbutils) - 简化安装和更新
+
+## 可用工具
+
+MCP 数据库工具提供了多种工具，使 AI 能够与您的数据库交互：
+
+- **dbutils-list-connections**：列出配置中的所有可用数据库连接
+- **dbutils-list-tables**：列出数据库中的所有表
+- **dbutils-run-query**：执行 SQL 查询（仅 SELECT）
+- **dbutils-get-stats**：获取表统计信息
+- **dbutils-list-constraints**：列出表约束
+- **dbutils-explain-query**：获取查询执行计划
+- **dbutils-get-performance**：获取数据库性能指标
+- **dbutils-analyze-query**：分析查询以进行优化
+
+有关这些工具的详细说明和使用示例，请参阅[使用指南](docs/zh/usage.md)。
+
+## 星标历史
+
+[![星标历史图表](https://starchart.cc/donghao1393/mcp-dbutils.svg?variant=adaptive)](https://starchart.cc/donghao1393/mcp-dbutils)
+
+## 许可证
+
+本项目采用 MIT 许可证 - 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。

mcp_dbutils-0.19.0/README_AR.md

@@ -0,0 +1,127 @@
+<div dir="rtl">
+
+# أدوات قواعد بيانات MCP
+
+<!-- شارات حالة المشروع -->
+[![حالة البناء](https://img.shields.io/github/workflow/status/donghao1393/mcp-dbutils/Quality%20Assurance?label=tests)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![التغطية](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/donghao1393/bdd0a63ec2a816539ff8c136ceb41e48/raw/coverage.json)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![حالة بوابة الجودة](https://sonarcloud.io/api/project_badges/measure?project=donghao1393_mcp-dbutils&metric=alert_status)](https://sonarcloud.io/dashboard?id=donghao1393_mcp-dbutils)
+
+<!-- شارات الإصدار والتثبيت -->
+[![إصدار PyPI](https://img.shields.io/pypi/v/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![تنزيلات PyPI](https://img.shields.io/pypi/dm/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![Smithery](https://smithery.ai/badge/@donghao1393/mcp-dbutils)](https://smithery.ai/server/@donghao1393/mcp-dbutils)
+
+<!-- شارات المواصفات التقنية -->
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![الترخيص](https://img.shields.io/github/license/donghao1393/mcp-dbutils)](LICENSE)
+[![نجوم GitHub](https://img.shields.io/github/stars/donghao1393/mcp-dbutils?style=social)](https://github.com/donghao1393/mcp-dbutils/stargazers)
+
+[English](README_EN.md) | [中文](README.md) | [Français](README_FR.md) | [Español](README_ES.md) | العربية | [Русский](README_RU.md) | [التوثيق](#التوثيق)
+
+## مقدمة
+
+أدوات قواعد بيانات MCP هي خدمة MCP شاملة تمكّن الذكاء الاصطناعي الخاص بك من إجراء تحليل البيانات من خلال الوصول إلى أنواع متنوعة من قواعد البيانات (SQLite وMySQL وPostgreSQL والمزيد) ضمن تكوين اتصال موحد بطريقة آمنة.
+
+فكر فيها كجسر آمن بين أنظمة الذكاء الاصطناعي وقواعد البيانات الخاصة بك، مما يسمح للذكاء الاصطناعي بقراءة وتحليل بياناتك دون الوصول المباشر إلى قاعدة البيانات أو المخاطرة بتعديلات البيانات.
+
+### الميزات الرئيسية
+
+- **الأمان أولاً**: عمليات للقراءة فقط بشكل صارم، لا وصول مباشر لقاعدة البيانات، اتصالات معزولة، اتصال عند الطلب، مهلات تلقائية
+- **ضمانات الخصوصية**: معالجة محلية، الحد الأدنى من كشف البيانات، حماية بيانات الاعتماد، إخفاء البيانات الحساسة
+- **دعم قواعد بيانات متعددة**: اتصل بـ SQLite وMySQL وPostgreSQL بنفس الواجهة
+- **تكوين بسيط**: ملف YAML واحد لجميع اتصالات قاعدة البيانات الخاصة بك
+- **قدرات متقدمة**: استكشاف الجداول، تحليل المخطط، وتنفيذ الاستعلامات
+
+> 🔒 **ملاحظة أمان**: تم بناء أدوات قواعد بيانات MCP بهندسة تضع الأمان في المقام الأول، مما يجعلها مثالية للشركات والشركات الناشئة والأفراد الذين يقدرون حماية البيانات. تعرف على المزيد حول [هندسة الأمان](docs/ar/technical/security.md) لدينا.
+
+## البدء السريع
+
+نقدم طرق تثبيت متعددة، بما في ذلك uvx وDocker وSmithery. للحصول على خطوات تثبيت وتكوين مفصلة، راجع [دليل التثبيت](docs/ar/installation.md).
+
+### الخطوات الأساسية
+
+1. **التثبيت**: اختر طريقة التثبيت المفضلة لديك ([تعليمات مفصلة](docs/ar/installation.md))
+2. **التكوين**: قم بإنشاء ملف YAML يحتوي على معلومات اتصال قاعدة البيانات الخاصة بك ([دليل التكوين](docs/ar/configuration.md))
+3. **الاتصال**: أضف التكوين إلى عميل الذكاء الاصطناعي الخاص بك
+4. **الاستخدام**: ابدأ التفاعل مع قواعد البيانات الخاصة بك ([دليل الاستخدام](docs/ar/usage.md))
+
+## أمثلة على التفاعلات
+
+**أنت**: "هل يمكنك سرد جميع الجداول في قاعدة بيانات my-postgres الخاصة بي؟"
+
+**الذكاء الاصطناعي**: "سأتحقق من ذلك لك. إليك الجداول في قاعدة بيانات my-postgres الخاصة بك:
+- العملاء
+- المنتجات
+- الطلبات
+- المخزون
+- الموظفون"
+
+**أنت**: "كيف يبدو جدول العملاء؟"
+
+**الذكاء الاصطناعي**: "جدول العملاء له البنية التالية:
+- id (عدد صحيح، مفتاح أساسي)
+- الاسم (نص)
+- البريد الإلكتروني (نص)
+- تاريخ_التسجيل (تاريخ)
+- آخر_شراء (تاريخ)
+- إجمالي_الإنفاق (رقمي)"
+
+**أنت**: "كم عدد العملاء الذين قاموا بعمليات شراء في الشهر الماضي؟"
+
+**الذكاء الاصطناعي**: "دعني أقوم بتشغيل استعلام لمعرفة ذلك... وفقًا للبيانات، قام 128 عميلاً بعمليات شراء في الشهر الماضي. بلغت القيمة الإجمالية لهذه المشتريات 25,437.82 دولارًا."
+
+## الأدوات المتاحة
+
+توفر أدوات قواعد بيانات MCP عدة أدوات يمكن للذكاء الاصطناعي الخاص بك استخدامها:
+
+- **dbutils-list-connections**: يسرد جميع اتصالات قاعدة البيانات المتاحة في التكوين الخاص بك
+- **dbutils-list-tables**: يسرد جميع الجداول في قاعدة البيانات
+- **dbutils-run-query**: ينفذ استعلام SQL (SELECT فقط)
+- **dbutils-get-stats**: يحصل على إحصائيات حول جدول
+- **dbutils-list-constraints**: يسرد قيود الجدول
+- **dbutils-explain-query**: يحصل على خطة تنفيذ الاستعلام
+- **dbutils-get-performance**: يحصل على مقاييس أداء قاعدة البيانات
+- **dbutils-analyze-query**: يحلل الاستعلامات للتحسين
+
+## التوثيق
+
+### البدء
+- [دليل التثبيت](docs/ar/installation.md) - خطوات تثبيت مفصلة وتعليمات التكوين
+- [دليل التثبيت الخاص بالمنصة](docs/ar/installation-platform-specific.md) - تعليمات التثبيت لأنظمة التشغيل المختلفة
+- [دليل التكوين](docs/ar/configuration.md) - أمثلة تكوين اتصال قاعدة البيانات وأفضل الممارسات
+- [دليل الاستخدام](docs/ar/usage.md) - سير العمل الأساسي وسيناريوهات الاستخدام الشائعة
+
+### التوثيق التقني
+- [تصميم الهندسة](docs/ar/technical/architecture.md) - هندسة النظام والمكونات
+- [هندسة الأمان](docs/ar/technical/security.md) - ميزات الأمان وآليات الحماية
+- [دليل التطوير](docs/ar/technical/development.md) - جودة الكود وسير عمل التطوير
+- [دليل الاختبار](docs/ar/technical/testing.md) - إطار الاختبار وأفضل الممارسات
+- [تكامل SonarCloud](docs/ar/technical/sonarcloud-integration.md) - دليل تكامل SonarCloud والذكاء الاصطناعي
+
+### توثيق الأمثلة
+- [أمثلة SQLite](docs/ar/examples/sqlite-examples.md) - أمثلة عمليات قاعدة بيانات SQLite
+- [أمثلة PostgreSQL](docs/ar/examples/postgresql-examples.md) - أمثلة عمليات قاعدة بيانات PostgreSQL
+- [أمثلة MySQL](docs/ar/examples/mysql-examples.md) - أمثلة عمليات قاعدة بيانات MySQL
+- [تفاعلات LLM المتقدمة](docs/ar/examples/advanced-llm-interactions.md) - أمثلة تفاعل متقدمة مع LLM المختلفة
+
+### الوثائق متعددة اللغات
+- **الإنجليزية** - [English Documentation](docs/en/)
+- **الصينية** - [中文文档](docs/zh/)
+- **الفرنسية** - [Documentation Française](docs/fr/)
+- **الإسبانية** - [Documentación en Español](docs/es/)
+- **الروسية** - [Документация на русском](docs/ru/)
+
+### الدعم والتعليقات
+- [مشكلات GitHub](https://github.com/donghao1393/mcp-dbutils/issues) - الإبلاغ عن المشكلات أو طلب الميزات
+- [Smithery](https://smithery.ai/server/@donghao1393/mcp-dbutils) - تثبيت وتحديثات مبسطة
+
+## تاريخ النجوم
+
+[![مخطط تاريخ النجوم](https://starchart.cc/donghao1393/mcp-dbutils.svg?variant=adaptive)](https://starchart.cc/donghao1393/mcp-dbutils)
+
+## الترخيص
+
+هذا المشروع مرخص بموجب ترخيص MIT - راجع ملف [LICENSE](LICENSE) للحصول على التفاصيل.
+
+</div>

mcp_dbutils-0.19.0/README_EN.md

@@ -0,0 +1,118 @@
+# MCP Database Utilities
+
+<!-- Project Status Badges -->
+[![Build Status](https://img.shields.io/github/workflow/status/donghao1393/mcp-dbutils/Quality%20Assurance?label=tests)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![Coverage](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/donghao1393/bdd0a63ec2a816539ff8c136ceb41e48/raw/coverage.json)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=donghao1393_mcp-dbutils&metric=alert_status)](https://sonarcloud.io/dashboard?id=donghao1393_mcp-dbutils)
+
+<!-- Version and Installation Badges -->
+[![PyPI version](https://img.shields.io/pypi/v/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![Smithery](https://smithery.ai/badge/@donghao1393/mcp-dbutils)](https://smithery.ai/server/@donghao1393/mcp-dbutils)
+
+<!-- Technical Specification Badges -->
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/github/license/donghao1393/mcp-dbutils)](LICENSE)
+[![GitHub Stars](https://img.shields.io/github/stars/donghao1393/mcp-dbutils?style=social)](https://github.com/donghao1393/mcp-dbutils/stargazers)
+
+[中文](README.md) | [Français](README_FR.md) | [Español](README_ES.md) | [العربية](README_AR.md) | [Русский](README_RU.md) | [Documentation](#documentation)
+
+## Introduction
+
+MCP Database Utilities is an all-in-one MCP service that enables your AI to do data analysis by accessing versatile types of database (SQLite, MySQL, PostgreSQL, and more) within a unified connection configuration in a safe way.
+
+Think of it as a secure bridge between AI systems and your databases, allowing AI to read and analyze your data without direct database access or risking data modifications.
+
+### Key Features
+
+- **Security First**: Strictly read-only operations, no direct database access, isolated connections, on-demand connectivity, automatic timeouts
+- **Privacy Safeguards**: Local processing, minimal data exposure, credential protection, sensitive data masking
+- **Multiple Database Support**: Connect to SQLite, MySQL, PostgreSQL with the same interface
+- **Simple Configuration**: Single YAML file for all your database connections
+- **Advanced Capabilities**: Table exploration, schema analysis, and query execution
+
+> 🔒 **Security Note**: MCP Database Utilities is built with a security-first architecture, making it ideal for businesses, startups, and individuals who value data protection. Learn more about our [security architecture](docs/en/technical/security.md).
+
+## Quick Start
+
+We offer multiple installation methods, including uvx, Docker, and Smithery. For detailed installation and configuration steps, see the [Installation Guide](docs/en/installation.md).
+
+### Basic Steps
+
+1. **Install**: Choose your preferred installation method ([detailed instructions](docs/en/installation.md))
+2. **Configure**: Create a YAML file with your database connection information ([configuration guide](docs/en/configuration.md))
+3. **Connect**: Add the configuration to your AI client
+4. **Use**: Start interacting with your databases ([usage guide](docs/en/usage.md))
+
+## Example Interactions
+
+**You**: "Can you list all the tables in my my-postgres database?"
+
+**AI**: "I'll check that for you. Here are the tables in your my-postgres database:
+- customers
+- products
+- orders
+- inventory
+- employees"
+
+**You**: "What does the customers table look like?"
+
+**AI**: "The customers table has the following structure:
+- id (integer, primary key)
+- name (text)
+- email (text)
+- registration_date (date)
+- last_purchase (date)
+- total_spent (numeric)"
+
+**You**: "How many customers made purchases in the last month?"
+
+**AI**: "Let me run a query to find out... According to the data, 128 customers made purchases in the last month. The total value of these purchases was $25,437.82."
+
+## Available Tools
+
+MCP Database Utilities provides several tools that your AI can use:
+
+- **dbutils-list-connections**: Lists all available database connections in your configuration
+- **dbutils-list-tables**: Lists all tables in a database
+- **dbutils-run-query**: Executes a SQL query (SELECT only)
+- **dbutils-get-stats**: Gets statistics about a table
+- **dbutils-list-constraints**: Lists table constraints
+- **dbutils-explain-query**: Gets query execution plan
+- **dbutils-get-performance**: Gets database performance metrics
+- **dbutils-analyze-query**: Analyzes queries for optimization
+
+
+
+## Documentation
+
+### Getting Started
+- [Installation Guide](docs/en/installation.md) - Detailed installation steps and configuration instructions
+- [Platform-Specific Installation Guide](docs/en/installation-platform-specific.md) - Installation instructions for different operating systems
+- [Configuration Guide](docs/en/configuration.md) - Database connection configuration examples and best practices
+- [Usage Guide](docs/en/usage.md) - Basic workflow and common usage scenarios
+
+### Technical Documentation
+- [Architecture Design](docs/en/technical/architecture.md) - System architecture and components
+- [Security Architecture](docs/en/technical/security.md) - Security features and protection mechanisms
+- [Development Guide](docs/en/technical/development.md) - Code quality and development workflow
+- [Testing Guide](docs/en/technical/testing.md) - Testing framework and best practices
+- [SonarCloud Integration](docs/en/technical/sonarcloud-integration.md) - SonarCloud and AI integration guide
+
+### Example Documentation
+- [SQLite Examples](docs/en/examples/sqlite-examples.md) - SQLite database operation examples
+- [PostgreSQL Examples](docs/en/examples/postgresql-examples.md) - PostgreSQL database operation examples
+- [MySQL Examples](docs/en/examples/mysql-examples.md) - MySQL database operation examples
+- [Advanced LLM Interactions](docs/en/examples/advanced-llm-interactions.md) - Advanced interaction examples with various LLMs
+
+### Support & Feedback
+- [GitHub Issues](https://github.com/donghao1393/mcp-dbutils/issues) - Report issues or request features
+- [Smithery](https://smithery.ai/server/@donghao1393/mcp-dbutils) - Simplified installation and updates
+
+## Star History
+
+[![Star History Chart](https://starchart.cc/donghao1393/mcp-dbutils.svg?variant=adaptive)](https://starchart.cc/donghao1393/mcp-dbutils)
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.