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

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

@@ -1,3 +1,10 @@
+# [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)
 
 

{mcp_dbutils-0.18.0 → mcp_dbutils-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-dbutils
-Version: 0.18.0
+Version: 0.19.0
 Summary: MCP Database Utilities Service
 Author: Dong Hao
 License-Expression: MIT
@@ -40,7 +40,7 @@ Description-Content-Type: text/markdown
 [![许可证](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) | [文档导航](#文档导航)
+[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)
 
@@ -110,6 +110,13 @@ MCP Database Utilities 是一个多功能的 MCP 服务，它使您的 AI 能够
 - [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_dbutils-0.18.0 → mcp_dbutils-0.19.0}/README.md

@@ -15,7 +15,7 @@
 [![许可证](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) | [文档导航](#文档导航)
+[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)
 
@@ -85,6 +85,13 @@ MCP Database Utilities 是一个多功能的 MCP 服务，它使您的 AI 能够
 - [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_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.18.0 → mcp_dbutils-0.19.0}/README_EN.md

@@ -15,7 +15,7 @@
 [![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) | [Documentation](#documentation)
+[中文](README.md) | [Français](README_FR.md) | [Español](README_ES.md) | [العربية](README_AR.md) | [Русский](README_RU.md) | [Documentation](#documentation)
 
 ## Introduction
 

mcp_dbutils-0.19.0/README_ES.md

@@ -0,0 +1,116 @@
+# MCP Database Utilities
+
+<!-- Insignias de estado del proyecto -->
+[![Estado de compilación](https://img.shields.io/github/workflow/status/donghao1393/mcp-dbutils/Quality%20Assurance?label=tests)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![Cobertura](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/donghao1393/bdd0a63ec2a816539ff8c136ceb41e48/raw/coverage.json)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![Estado de Quality Gate](https://sonarcloud.io/api/project_badges/measure?project=donghao1393_mcp-dbutils&metric=alert_status)](https://sonarcloud.io/dashboard?id=donghao1393_mcp-dbutils)
+
+<!-- Insignias de versión e instalación -->
+[![Versión de PyPI](https://img.shields.io/pypi/v/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![Descargas de 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)
+
+<!-- Insignias de especificaciones técnicas -->
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![Licencia](https://img.shields.io/github/license/donghao1393/mcp-dbutils)](LICENSE)
+[![Estrellas de 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) | [العربية](README_AR.md) | [Русский](README_RU.md) | [Documentación](#documentación)
+
+## Introducción
+
+MCP Database Utilities es un servicio MCP todo en uno que permite a tu IA realizar análisis de datos accediendo a diversos tipos de bases de datos (SQLite, MySQL, PostgreSQL y más) con una configuración de conexión unificada de manera segura.
+
+Piensa en ello como un puente seguro entre los sistemas de IA y tus bases de datos, permitiendo a la IA leer y analizar tus datos sin acceso directo a la base de datos o arriesgarse a modificaciones de datos.
+
+### Características clave
+
+- **Seguridad primero**: Operaciones estrictamente de solo lectura, sin acceso directo a la base de datos, conexiones aisladas, conectividad bajo demanda, tiempos de espera automáticos
+- **Protecciones de privacidad**: Procesamiento local, exposición mínima de datos, protección de credenciales, enmascaramiento de datos sensibles
+- **Soporte para múltiples bases de datos**: Conéctate a SQLite, MySQL, PostgreSQL con la misma interfaz
+- **Configuración simple**: Un solo archivo YAML para todas tus conexiones de base de datos
+- **Capacidades avanzadas**: Exploración de tablas, análisis de esquemas y ejecución de consultas
+
+> 🔒 **Nota de seguridad**: MCP Database Utilities está construido con una arquitectura de seguridad primero, lo que lo hace ideal para empresas, startups e individuos que valoran la protección de datos. Aprende más sobre nuestra [arquitectura de seguridad](docs/es/technical/security.md).
+
+## Inicio rápido
+
+Ofrecemos múltiples métodos de instalación, incluyendo uvx, Docker y Smithery. Para pasos detallados de instalación y configuración, consulta la [Guía de instalación](docs/es/installation.md).
+
+### Pasos básicos
+
+1. **Instalar**: Elige tu método de instalación preferido ([instrucciones detalladas](docs/es/installation.md))
+2. **Configurar**: Crea un archivo YAML con la información de conexión de tu base de datos ([guía de configuración](docs/es/configuration.md))
+3. **Conectar**: Añade la configuración a tu cliente de IA
+4. **Usar**: Comienza a interactuar con tus bases de datos ([guía de uso](docs/es/usage.md))
+
+## Ejemplos de interacciones
+
+**Tú**: "¿Puedes listar todas las tablas en mi base de datos my-postgres?"
+
+**IA**: "Verificaré eso para ti. Aquí están las tablas en tu base de datos my-postgres:
+- clientes
+- productos
+- pedidos
+- inventario
+- empleados"
+
+**Tú**: "¿Cómo es la tabla de clientes?"
+
+**IA**: "La tabla de clientes tiene la siguiente estructura:
+- id (entero, clave primaria)
+- nombre (texto)
+- email (texto)
+- fecha_registro (fecha)
+- ultima_compra (fecha)
+- total_gastado (numérico)"
+
+**Tú**: "¿Cuántos clientes realizaron compras en el último mes?"
+
+**IA**: "Déjame ejecutar una consulta para averiguarlo... Según los datos, 128 clientes realizaron compras en el último mes. El valor total de estas compras fue de $25,437.82."
+
+## Herramientas disponibles
+
+MCP Database Utilities proporciona varias herramientas que tu IA puede usar:
+
+- **dbutils-list-connections**: Lista todas las conexiones de base de datos disponibles en tu configuración
+- **dbutils-list-tables**: Lista todas las tablas en una base de datos
+- **dbutils-run-query**: Ejecuta una consulta SQL (solo SELECT)
+- **dbutils-get-stats**: Obtiene estadísticas sobre una tabla
+- **dbutils-list-constraints**: Lista las restricciones de una tabla
+- **dbutils-explain-query**: Obtiene el plan de ejecución de la consulta
+- **dbutils-get-performance**: Obtiene métricas de rendimiento de la base de datos
+- **dbutils-analyze-query**: Analiza consultas para optimización
+
+## Documentación
+
+### Primeros pasos
+- [Guía de instalación](docs/es/installation.md) - Pasos detallados de instalación e instrucciones de configuración
+- [Guía de instalación específica de plataforma](docs/es/installation-platform-specific.md) - Instrucciones de instalación para diferentes sistemas operativos
+- [Guía de configuración](docs/es/configuration.md) - Ejemplos de configuración de conexión de base de datos y mejores prácticas
+- [Guía de uso](docs/es/usage.md) - Flujo de trabajo básico y escenarios de uso comunes
+
+### Documentación técnica
+- [Diseño de arquitectura](docs/es/technical/architecture.md) - Arquitectura del sistema y componentes
+- [Arquitectura de seguridad](docs/es/technical/security.md) - Características de seguridad y mecanismos de protección
+- [Guía de desarrollo](docs/es/technical/development.md) - Calidad del código y flujo de trabajo de desarrollo
+- [Guía de pruebas](docs/es/technical/testing.md) - Marco de pruebas y mejores prácticas
+- [Integración con SonarCloud](docs/es/technical/sonarcloud-integration.md) - Guía de integración de SonarCloud y IA
+
+### Documentación de ejemplos
+- [Ejemplos de SQLite](docs/es/examples/sqlite-examples.md) - Ejemplos de operaciones de base de datos SQLite
+- [Ejemplos de PostgreSQL](docs/es/examples/postgresql-examples.md) - Ejemplos de operaciones de base de datos PostgreSQL
+- [Ejemplos de MySQL](docs/es/examples/mysql-examples.md) - Ejemplos de operaciones de base de datos MySQL
+- [Interacciones avanzadas con LLM](docs/es/examples/advanced-llm-interactions.md) - Ejemplos de interacciones avanzadas con varios LLM
+
+### Soporte y comentarios
+- [Issues de GitHub](https://github.com/donghao1393/mcp-dbutils/issues) - Reporta problemas o solicita características
+- [Smithery](https://smithery.ai/server/@donghao1393/mcp-dbutils) - Instalación y actualizaciones simplificadas
+
+## Historial de estrellas
+
+[![Gráfico de historial de estrellas](https://starchart.cc/donghao1393/mcp-dbutils.svg?variant=adaptive)](https://starchart.cc/donghao1393/mcp-dbutils)
+
+## Licencia
+
+Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo [LICENSE](LICENSE) para más detalles.

mcp_dbutils-0.19.0/README_FR.md

@@ -0,0 +1,116 @@
+# MCP Database Utilities
+
+<!-- Badges d'état du projet -->
+[![État de la construction](https://img.shields.io/github/workflow/status/donghao1393/mcp-dbutils/Quality%20Assurance?label=tests)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![Couverture](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/donghao1393/bdd0a63ec2a816539ff8c136ceb41e48/raw/coverage.json)](https://github.com/donghao1393/mcp-dbutils/actions)
+[![Statut de la porte de qualité](https://sonarcloud.io/api/project_badges/measure?project=donghao1393_mcp-dbutils&metric=alert_status)](https://sonarcloud.io/dashboard?id=donghao1393_mcp-dbutils)
+
+<!-- Badges de version et d'installation -->
+[![Version PyPI](https://img.shields.io/pypi/v/mcp-dbutils)](https://pypi.org/project/mcp-dbutils/)
+[![Téléchargements 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)
+
+<!-- Badges de spécifications techniques -->
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![Licence](https://img.shields.io/github/license/donghao1393/mcp-dbutils)](LICENSE)
+[![Étoiles 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) | [Español](README_ES.md) | [العربية](README_AR.md) | [Русский](README_RU.md) | [Documentation](#documentation)
+
+## Introduction
+
+MCP Database Utilities est un service MCP tout-en-un qui permet à votre IA d'effectuer des analyses de données en accédant à différents types de bases de données (SQLite, MySQL, PostgreSQL, et plus) avec une configuration de connexion unifiée de manière sécurisée.
+
+Considérez-le comme un pont sécurisé entre les systèmes d'IA et vos bases de données, permettant à l'IA de lire et d'analyser vos données sans accès direct à la base de données ou sans risquer de modifications des données.
+
+### Caractéristiques clés
+
+- **Sécurité d'abord** : Opérations strictement en lecture seule, pas d'accès direct à la base de données, connexions isolées, connectivité à la demande, délais d'expiration automatiques
+- **Protection de la vie privée** : Traitement local, exposition minimale des données, protection des identifiants, masquage des données sensibles
+- **Support de multiples bases de données** : Connectez-vous à SQLite, MySQL, PostgreSQL avec la même interface
+- **Configuration simple** : Un seul fichier YAML pour toutes vos connexions de base de données
+- **Capacités avancées** : Exploration de tables, analyse de schéma et exécution de requêtes
+
+> 🔒 **Note de sécurité** : MCP Database Utilities est construit avec une architecture axée sur la sécurité, ce qui le rend idéal pour les entreprises, les startups et les particuliers qui valorisent la protection des données. En savoir plus sur notre [architecture de sécurité](docs/fr/technical/security.md).
+
+## Démarrage rapide
+
+Nous proposons plusieurs méthodes d'installation, notamment uvx, Docker et Smithery. Pour des étapes détaillées d'installation et de configuration, consultez le [Guide d'installation](docs/fr/installation.md).
+
+### Étapes de base
+
+1. **Installer** : Choisissez votre méthode d'installation préférée ([instructions détaillées](docs/fr/installation.md))
+2. **Configurer** : Créez un fichier YAML avec les informations de connexion à votre base de données ([guide de configuration](docs/fr/configuration.md))
+3. **Connecter** : Ajoutez la configuration à votre client IA
+4. **Utiliser** : Commencez à interagir avec vos bases de données ([guide d'utilisation](docs/fr/usage.md))
+
+## Exemples d'interactions
+
+**Vous** : "Pouvez-vous lister toutes les tables dans ma base de données my-postgres ?"
+
+**IA** : "Je vais vérifier cela pour vous. Voici les tables dans votre base de données my-postgres :
+- clients
+- produits
+- commandes
+- inventaire
+- employés"
+
+**Vous** : "À quoi ressemble la table clients ?"
+
+**IA** : "La table clients a la structure suivante :
+- id (entier, clé primaire)
+- nom (texte)
+- email (texte)
+- date_inscription (date)
+- dernier_achat (date)
+- total_depense (numérique)"
+
+**Vous** : "Combien de clients ont effectué des achats le mois dernier ?"
+
+**IA** : "Laissez-moi exécuter une requête pour le savoir... Selon les données, 128 clients ont effectué des achats le mois dernier. La valeur totale de ces achats était de 25 437,82 €."
+
+## Outils disponibles
+
+MCP Database Utilities fournit plusieurs outils que votre IA peut utiliser :
+
+- **dbutils-list-connections** : Liste toutes les connexions de base de données disponibles dans votre configuration
+- **dbutils-list-tables** : Liste toutes les tables d'une base de données
+- **dbutils-run-query** : Exécute une requête SQL (SELECT uniquement)
+- **dbutils-get-stats** : Obtient des statistiques sur une table
+- **dbutils-list-constraints** : Liste les contraintes de table
+- **dbutils-explain-query** : Obtient le plan d'exécution de la requête
+- **dbutils-get-performance** : Obtient des métriques de performance de la base de données
+- **dbutils-analyze-query** : Analyse les requêtes pour l'optimisation
+
+## Documentation
+
+### Mise en route
+- [Guide d'installation](docs/fr/installation.md) - Étapes d'installation détaillées et instructions de configuration
+- [Guide d'installation spécifique à la plateforme](docs/fr/installation-platform-specific.md) - Instructions d'installation pour différents systèmes d'exploitation
+- [Guide de configuration](docs/fr/configuration.md) - Exemples de configuration de connexion à la base de données et meilleures pratiques
+- [Guide d'utilisation](docs/fr/usage.md) - Flux de travail de base et scénarios d'utilisation courants
+
+### Documentation technique
+- [Conception de l'architecture](docs/fr/technical/architecture.md) - Architecture du système et composants
+- [Architecture de sécurité](docs/fr/technical/security.md) - Fonctionnalités de sécurité et mécanismes de protection
+- [Guide de développement](docs/fr/technical/development.md) - Qualité du code et flux de travail de développement
+- [Guide de test](docs/fr/technical/testing.md) - Framework de test et meilleures pratiques
+- [Intégration SonarCloud](docs/fr/technical/sonarcloud-integration.md) - Guide d'intégration SonarCloud et IA
+
+### Documentation d'exemples
+- [Exemples SQLite](docs/fr/examples/sqlite-examples.md) - Exemples d'opérations de base de données SQLite
+- [Exemples PostgreSQL](docs/fr/examples/postgresql-examples.md) - Exemples d'opérations de base de données PostgreSQL
+- [Exemples MySQL](docs/fr/examples/mysql-examples.md) - Exemples d'opérations de base de données MySQL
+- [Interactions LLM avancées](docs/fr/examples/advanced-llm-interactions.md) - Exemples d'interactions avancées avec divers LLM
+
+### Support et commentaires
+- [Problèmes GitHub](https://github.com/donghao1393/mcp-dbutils/issues) - Signaler des problèmes ou demander des fonctionnalités
+- [Smithery](https://smithery.ai/server/@donghao1393/mcp-dbutils) - Installation et mises à jour simplifiées
+
+## Historique des étoiles
+
+[![Graphique d'historique des étoiles](https://starchart.cc/donghao1393/mcp-dbutils.svg?variant=adaptive)](https://starchart.cc/donghao1393/mcp-dbutils)
+
+## Licence
+
+Ce projet est sous licence MIT - voir le fichier [LICENSE](LICENSE) pour plus de détails.

mcp_dbutils-0.19.0/README_RU.md

@@ -0,0 +1,123 @@
+# MCP Database Utilities
+
+<!-- Значки состояния проекта -->
+[![Статус сборки](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)
+[![Статус Quality Gate](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_AR.md) | Русский | [Документация](#документация)
+
+## Введение
+
+MCP Database Utilities — это универсальный сервис MCP, который позволяет вашему ИИ выполнять анализ данных, получая доступ к различным типам баз данных (SQLite, MySQL, PostgreSQL и другие) с единой конфигурацией подключения безопасным способом.
+
+Представьте его как безопасный мост между системами ИИ и вашими базами данных, позволяющий ИИ читать и анализировать ваши данные без прямого доступа к базе данных или риска изменения данных.
+
+### Ключевые особенности
+
+- **Безопасность прежде всего**: Строго операции только для чтения, отсутствие прямого доступа к базе данных, изолированные соединения, подключение по требованию, автоматические тайм-ауты
+- **Защита конфиденциальности**: Локальная обработка, минимальное раскрытие данных, защита учетных данных, маскирование конфиденциальных данных
+- **Поддержка нескольких баз данных**: Подключение к SQLite, MySQL, PostgreSQL с одним и тем же интерфейсом
+- **Простая конфигурация**: Один файл YAML для всех ваших подключений к базам данных
+- **Расширенные возможности**: Исследование таблиц, анализ схемы и выполнение запросов
+
+> 🔒 **Примечание по безопасности**: MCP Database Utilities создан с архитектурой, ориентированной на безопасность, что делает его идеальным для предприятий, стартапов и частных лиц, которые ценят защиту данных. Узнайте больше о нашей [архитектуре безопасности](docs/ru/technical/security.md).
+
+## Быстрый старт
+
+Мы предлагаем несколько методов установки, включая uvx, Docker и Smithery. Для подробных шагов по установке и настройке см. [Руководство по установке](docs/ru/installation.md).
+
+### Основные шаги
+
+1. **Установка**: Выберите предпочтительный метод установки ([подробные инструкции](docs/ru/installation.md))
+2. **Настройка**: Создайте файл YAML с информацией о подключении к вашей базе данных ([руководство по настройке](docs/ru/configuration.md))
+3. **Подключение**: Добавьте конфигурацию в ваш ИИ-клиент
+4. **Использование**: Начните взаимодействие с вашими базами данных ([руководство по использованию](docs/ru/usage.md))
+
+## Примеры взаимодействия
+
+**Вы**: "Можете ли вы перечислить все таблицы в моей базе данных my-postgres?"
+
+**ИИ**: "Я проверю это для вас. Вот таблицы в вашей базе данных my-postgres:
+- клиенты
+- продукты
+- заказы
+- инвентарь
+- сотрудники"
+
+**Вы**: "Как выглядит таблица клиентов?"
+
+**ИИ**: "Таблица клиентов имеет следующую структуру:
+- id (целое число, первичный ключ)
+- имя (текст)
+- email (текст)
+- дата_регистрации (дата)
+- последняя_покупка (дата)
+- общая_сумма_покупок (числовое значение)"
+
+**Вы**: "Сколько клиентов совершили покупки в прошлом месяце?"
+
+**ИИ**: "Позвольте мне выполнить запрос, чтобы узнать... Согласно данным, 128 клиентов совершили покупки в прошлом месяце. Общая стоимость этих покупок составила $25,437.82."
+
+## Доступные инструменты
+
+MCP Database Utilities предоставляет несколько инструментов, которые может использовать ваш ИИ:
+
+- **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/ru/installation.md) - Подробные шаги по установке и инструкции по настройке
+- [Руководство по установке для конкретных платформ](docs/ru/installation-platform-specific.md) - Инструкции по установке для различных операционных систем
+- [Руководство по настройке](docs/ru/configuration.md) - Примеры настройки подключения к базе данных и лучшие практики
+- [Руководство по использованию](docs/ru/usage.md) - Основной рабочий процесс и распространенные сценарии использования
+
+### Техническая документация
+- [Архитектурный дизайн](docs/ru/technical/architecture.md) - Архитектура системы и компоненты
+- [Архитектура безопасности](docs/ru/technical/security.md) - Функции безопасности и механизмы защиты
+- [Руководство по разработке](docs/ru/technical/development.md) - Качество кода и рабочий процесс разработки
+- [Руководство по тестированию](docs/ru/technical/testing.md) - Фреймворк тестирования и лучшие практики
+- [Интеграция с SonarCloud](docs/ru/technical/sonarcloud-integration.md) - Руководство по интеграции SonarCloud и ИИ
+
+### Документация с примерами
+- [Примеры SQLite](docs/ru/examples/sqlite-examples.md) - Примеры операций с базой данных SQLite
+- [Примеры PostgreSQL](docs/ru/examples/postgresql-examples.md) - Примеры операций с базой данных PostgreSQL
+- [Примеры MySQL](docs/ru/examples/mysql-examples.md) - Примеры операций с базой данных MySQL
+- [Расширенные взаимодействия с LLM](docs/ru/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/ar/)
+
+### Поддержка и обратная связь
+- [GitHub Issues](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) для получения подробной информации.