mcp-dbutils 0.21.0__tar.gz → 0.22.0__tar.gz

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.22.0](https://github.com/donghao1393/mcp-dbutils/compare/v0.21.0...v0.22.0) (2025-05-01)
+
+
+### Features
+
+* 更新多语言文档中的工具描述 ([#83](https://github.com/donghao1393/mcp-dbutils/issues/83)) ([45c3c05](https://github.com/donghao1393/mcp-dbutils/commit/45c3c053975405f9d5e028d6d9441ab8e8de1a65))
+
 # [0.21.0](https://github.com/donghao1393/mcp-dbutils/compare/v0.20.1...v0.21.0) (2025-05-01)
 
 

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-dbutils
-Version: 0.21.0
+Version: 0.22.0
 Summary: MCP Database Utilities Service
 Author: Dong Hao
 License-Expression: MIT

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/README_AR.md

@@ -75,14 +75,19 @@
 
 توفر أدوات قواعد بيانات 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**: يحلل الاستعلامات للتحسين
+- **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، مع توفير خطة التنفيذ ووقت التنفيذ الفعلي وتوصيات محددة للتحسين.
+
+لمزيد من الوصف التفصيلي وأمثلة استخدام هذه الأدوات، راجع [دليل الاستخدام](docs/ar/usage.md).
 
 ## التوثيق
 

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/README_ES.md

@@ -73,14 +73,19 @@ Ofrecemos múltiples métodos de instalación, incluyendo uvx, Docker y Smithery
 
 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
+- **dbutils-list-connections**: Lista todas las conexiones de base de datos disponibles con información detallada, incluyendo tipo de base de datos, host, puerto y nombre de base de datos, mientras oculta información sensible como contraseñas.
+- **dbutils-list-tables**: Lista todas las tablas en la conexión de base de datos especificada con nombres de tablas, URIs y descripciones disponibles, agrupadas por tipo de base de datos para fácil identificación.
+- **dbutils-run-query**: Ejecuta consultas SQL de solo lectura (solo SELECT) con soporte para consultas complejas, incluyendo JOINs, GROUP BY y funciones de agregación, devolviendo resultados estructurados con nombres de columnas y filas de datos.
+- **dbutils-describe-table**: Proporciona información detallada sobre la estructura de una tabla, incluyendo nombres de columnas, tipos de datos, nulabilidad, valores predeterminados y comentarios en un formato fácil de leer.
+- **dbutils-get-ddl**: Recupera la declaración DDL (Lenguaje de Definición de Datos) completa para crear la tabla especificada, incluyendo todas las definiciones de columnas, restricciones e índices.
+- **dbutils-list-indexes**: Lista todos los índices en la tabla especificada, incluyendo nombres de índices, tipos (único/no único), métodos de índice y columnas incluidas, agrupados por nombre de índice.
+- **dbutils-get-stats**: Recupera información estadística sobre la tabla, incluyendo recuento estimado de filas, longitud promedio de fila, tamaño de datos y tamaño de índice.
+- **dbutils-list-constraints**: Lista todas las restricciones en la tabla, incluyendo claves primarias, claves foráneas, restricciones únicas y restricciones de verificación, con tablas y columnas referenciadas para claves foráneas.
+- **dbutils-explain-query**: Proporciona el plan de ejecución para una consulta SQL, mostrando cómo el motor de base de datos procesará la consulta, incluyendo métodos de acceso, tipos de unión y costos estimados.
+- **dbutils-get-performance**: Recupera métricas de rendimiento para la conexión de base de datos, incluyendo recuento de consultas, tiempo promedio de ejecución, uso de memoria y estadísticas de errores.
+- **dbutils-analyze-query**: Analiza las características de rendimiento de una consulta SQL, proporcionando plan de ejecución, tiempo real de ejecución y recomendaciones específicas de optimización.
+
+Para descripciones detalladas y ejemplos de uso de estas herramientas, consulta la [Guía de Uso](docs/es/usage.md).
 
 ## Documentación
 

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/README_FR.md

@@ -73,14 +73,19 @@ Nous proposons plusieurs méthodes d'installation, notamment uvx, Docker et Smit
 
 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
+- **dbutils-list-connections** : Liste toutes les connexions de base de données disponibles avec des informations détaillées, notamment le type de base de données, l'hôte, le port et le nom de la base de données, tout en masquant les informations sensibles comme les mots de passe.
+- **dbutils-list-tables** : Liste toutes les tables de la connexion de base de données spécifiée avec les noms de tables, les URI et les descriptions disponibles, regroupées par type de base de données pour une identification facile.
+- **dbutils-run-query** : Exécute des requêtes SQL en lecture seule (SELECT uniquement) avec prise en charge de requêtes complexes, notamment JOIN, GROUP BY et fonctions d'agrégation, renvoyant des résultats structurés avec des noms de colonnes et des lignes de données.
+- **dbutils-describe-table** : Fournit des informations détaillées sur la structure d'une table, notamment les noms de colonnes, les types de données, la nullabilité, les valeurs par défaut et les commentaires dans un format facile à lire.
+- **dbutils-get-ddl** : Récupère l'instruction DDL (Data Definition Language) complète pour créer la table spécifiée, y compris toutes les définitions de colonnes, contraintes et index.
+- **dbutils-list-indexes** : Liste tous les index sur la table spécifiée, y compris les noms d'index, les types (unique/non unique), les méthodes d'index et les colonnes incluses, regroupés par nom d'index.
+- **dbutils-get-stats** : Récupère des informations statistiques sur la table, notamment le nombre estimé de lignes, la longueur moyenne des lignes, la taille des données et la taille de l'index.
+- **dbutils-list-constraints** : Liste toutes les contraintes sur la table, y compris les clés primaires, les clés étrangères, les contraintes uniques et les contraintes de vérification, avec les tables et colonnes référencées pour les clés étrangères.
+- **dbutils-explain-query** : Fournit le plan d'exécution d'une requête SQL, montrant comment le moteur de base de données traitera la requête, y compris les méthodes d'accès, les types de jointure et les coûts estimés.
+- **dbutils-get-performance** : Obtient des métriques de performance de la base de données, notamment le nombre de requêtes, le temps d'exécution moyen, l'utilisation de la mémoire et les statistiques d'erreur.
+- **dbutils-analyze-query** : Analyse les caractéristiques de performance d'une requête SQL, fournissant un plan d'exécution, un temps d'exécution réel et des recommandations d'optimisation spécifiques.
+
+Pour des descriptions détaillées et des exemples d'utilisation de ces outils, consultez le [Guide d'utilisation](docs/fr/usage.md).
 
 ## Documentation
 

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/README_RU.md

@@ -73,14 +73,19 @@ MCP Database Utilities — это универсальный сервис MCP,
 
 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**: Анализирует запросы для оптимизации
+- **dbutils-list-connections**: Перечисляет все доступные подключения к базам данных с подробной информацией, включая тип базы данных, хост, порт и имя базы данных, скрывая конфиденциальную информацию, такую как пароли.
+- **dbutils-list-tables**: Перечисляет все таблицы в указанном подключении к базе данных с именами таблиц, URI и доступными описаниями, сгруппированными по типу базы данных для удобной идентификации.
+- **dbutils-run-query**: Выполняет запросы SQL только для чтения (только SELECT) с поддержкой сложных запросов, включая JOIN, GROUP BY и агрегатные функции, возвращая структурированные результаты с именами столбцов и строками данных.
+- **dbutils-describe-table**: Предоставляет подробную информацию о структуре таблицы, включая имена столбцов, типы данных, допустимость NULL, значения по умолчанию и комментарии в удобочитаемом формате.
+- **dbutils-get-ddl**: Получает полный оператор DDL (язык определения данных) для создания указанной таблицы, включая все определения столбцов, ограничения и индексы.
+- **dbutils-list-indexes**: Перечисляет все индексы в указанной таблице, включая имена индексов, типы (уникальный/неуникальный), методы индексирования и включенные столбцы, сгруппированные по имени индекса.
+- **dbutils-get-stats**: Получает статистическую информацию о таблице, включая предполагаемое количество строк, среднюю длину строки, размер данных и размер индекса.
+- **dbutils-list-constraints**: Перечисляет все ограничения в таблице, включая первичные ключи, внешние ключи, уникальные ограничения и ограничения проверки, с таблицами и столбцами, на которые ссылаются внешние ключи.
+- **dbutils-explain-query**: Предоставляет план выполнения для SQL-запроса, показывая, как движок базы данных будет обрабатывать запрос, включая методы доступа, типы соединений и предполагаемые затраты.
+- **dbutils-get-performance**: Получает метрики производительности для подключения к базе данных, включая количество запросов, среднее время выполнения, использование памяти и статистику ошибок.
+- **dbutils-analyze-query**: Анализирует характеристики производительности SQL-запроса, предоставляя план выполнения, фактическое время выполнения и конкретные рекомендации по оптимизации.
+
+Для подробных описаний и примеров использования этих инструментов см. [Руководство по использованию](docs/ru/usage.md).
 
 ## Документация
 

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/docs/ar/usage.md

@@ -21,7 +21,7 @@
 
 ### dbutils-list-connections
 
-يسرد جميع اتصالات قاعدة البيانات المتاحة المحددة في التكوين الخاص بك.
+يسرد جميع اتصالات قاعدة البيانات المتاحة مع معلومات مفصلة تشمل نوع قاعدة البيانات والمضيف والمنفذ واسم قاعدة البيانات، مع إخفاء المعلومات الحساسة مثل كلمات المرور. المعلمة الاختيارية check_status تسمح بالتحقق مما إذا كان كل اتصال متاحًا، على الرغم من أن هذا قد يزيد من وقت الاستجابة. استخدم هذه الأداة عندما تحتاج إلى فهم موارد قاعدة البيانات المتاحة أو تشخيص مشكلات الاتصال.
 
 **مثال على التفاعل**:
 
@@ -47,7 +47,7 @@
 
 ### dbutils-list-tables
 
-يسرد جميع الجداول في قاعدة البيانات المحددة.
+يسرد جميع الجداول في اتصال قاعدة البيانات المحدد مع أسماء الجداول وعناوين URI والأوصاف المتاحة، مجمعة حسب نوع قاعدة البيانات لسهولة التعرف عليها. هذه الأداة مفيدة لاستكشاف بنية قاعدة البيانات وفهم الجداول المتاحة للتحليل.
 
 **مثال على التفاعل**:
 
@@ -62,7 +62,7 @@
 
 ### dbutils-run-query
 
-ينفذ استعلامات SQL على قاعدة البيانات المحددة (عمليات SELECT فقط).
+ينفذ استعلامات SQL للقراءة فقط (SELECT فقط) على قاعدة البيانات المحددة، مع دعم للاستعلامات المعقدة، بما في ذلك JOIN وGROUP BY ووظائف التجميع، مع إرجاع نتائج منظمة تتضمن أسماء الأعمدة وصفوف البيانات. هذه الأداة ضرورية لاستخراج معلومات محددة من قواعد البيانات وإجراء تحليلات مخصصة.
 
 **مثال على التفاعل**:
 
@@ -70,9 +70,79 @@
 
 **الذكاء الاصطناعي**: "سأتحقق من ذلك لك. وفقًا للبيانات، كان هناك 42 تسجيلًا جديدًا للعملاء في آخر 30 يومًا."
 
+### dbutils-describe-table
+
+يوفر معلومات مفصلة عن بنية الجدول، بما في ذلك أسماء الأعمدة وأنواع البيانات وإمكانية الخلو والقيم الافتراضية والتعليقات بتنسيق سهل القراءة. هذه الأداة مفيدة بشكل خاص لفهم مخطط الجدول قبل تنفيذ الاستعلامات أو تحليل البيانات.
+
+**مثال على التفاعل**:
+
+**أنت**: "صف بنية جدول العملاء."
+
+**الذكاء الاصطناعي**: "إليك بنية جدول العملاء:
+| العمود | النوع | قابل للخلو | افتراضي | الوصف |
+|---------|------|----------|--------|-------------|
+| id | INTEGER | لا | NULL | معرف فريد للعميل |
+| name | VARCHAR(100) | لا | NULL | الاسم الكامل للعميل |
+| email | VARCHAR(100) | لا | NULL | عنوان البريد الإلكتروني (فريد) |
+| registration_date | DATE | لا | CURRENT_DATE | تاريخ التسجيل |
+| last_login | TIMESTAMP | نعم | NULL | الطابع الزمني لآخر تسجيل دخول |
+| status | ENUM | لا | 'نشط' | حالة الحساب (نشط، غير نشط، معلق) |"
+
+### dbutils-get-ddl
+
+يسترجع بيان DDL (لغة تعريف البيانات) الكامل لإنشاء الجدول المحدد، بما في ذلك جميع تعريفات الأعمدة والقيود والفهارس. هذه الأداة مفيدة لفهم التعريف الدقيق للجدول أو لإعادة إنشاء بنية جدول مماثلة في بيئة أخرى.
+
+**مثال على التفاعل**:
+
+**أنت**: "أظهر لي DDL لجدول الطلبات."
+
+**الذكاء الاصطناعي**: "إليك بيان DDL لجدول الطلبات:
+```sql
+CREATE TABLE orders (
+  order_id INT PRIMARY KEY AUTO_INCREMENT,
+  customer_id INT NOT NULL,
+  order_date DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  total_amount DECIMAL(10,2) NOT NULL CHECK (total_amount > 0),
+  status VARCHAR(20) NOT NULL DEFAULT 'pending',
+  FOREIGN KEY (customer_id) REFERENCES customers(id)
+);
+
+CREATE INDEX idx_order_date ON orders(order_date);
+CREATE INDEX idx_customer_id ON orders(customer_id);
+```"
+
+### dbutils-list-indexes
+
+يسرد جميع الفهارس على الجدول المحدد، بما في ذلك أسماء الفهارس والأنواع (فريد/غير فريد) وطرق الفهرسة والأعمدة المضمنة، مجمعة حسب اسم الفهرس. هذه الأداة مفيدة لفهم كيفية فهرسة الجدول، مما يمكن أن يساعد في تحسين الاستعلامات وتحسين الأداء.
+
+**مثال على التفاعل**:
+
+**أنت**: "ما هي الفهارس الموجودة على جدول المنتجات؟"
+
+**الذكاء الاصطناعي**: "إليك الفهارس على جدول المنتجات:
+1. **pk_product_id** (أساسي)
+   - الأعمدة: product_id
+   - النوع: B-tree
+   - فريد: نعم
+
+2. **idx_category** (ثانوي)
+   - الأعمدة: category_id
+   - النوع: B-tree
+   - فريد: لا
+
+3. **idx_product_name** (ثانوي)
+   - الأعمدة: name
+   - النوع: B-tree
+   - فريد: لا
+
+4. **idx_price_category** (ثانوي)
+   - الأعمدة: price, category_id
+   - النوع: B-tree
+   - فريد: لا"
+
 ### dbutils-get-stats
 
-يحصل على إحصائيات حول جدول، مثل عدد الصفوف والحجم وإحصائيات العمود.
+يسترجع معلومات إحصائية عن الجدول، بما في ذلك العدد التقديري للصفوف ومتوسط طول الصف وحجم البيانات وحجم الفهرس. هذه الإحصائيات مفيدة لفهم حجم البيانات وتخطيط تحسينات الأداء.
 
 **مثال على التفاعل**:
 
@@ -88,7 +158,7 @@
 
 ### dbutils-list-constraints
 
-يسرد القيود للجدول، مثل المفاتيح الأساسية والمفاتيح الخارجية وما إلى ذلك.
+يسرد جميع القيود على الجدول، بما في ذلك المفاتيح الأساسية والمفاتيح الخارجية والقيود الفريدة وقيود التحقق، مع الجداول والأعمدة المرجعية للمفاتيح الخارجية. هذه الأداة مفيدة لفهم العلاقات بين الجداول وقواعد سلامة البيانات.
 
 **مثال على التفاعل**:
 
@@ -102,7 +172,7 @@
 
 ### dbutils-explain-query
 
-يحصل على خطة تنفيذ الاستعلام وتقديرات التكلفة.
+يوفر خطة تنفيذ لاستعلام SQL، موضحًا كيف سيعالج محرك قاعدة البيانات الاستعلام، بما في ذلك طرق الوصول وأنواع الربط والتكاليف المقدرة. هذه الأداة ضرورية لفهم وتحسين أداء الاستعلامات المعقدة.
 
 **مثال على التفاعل**:
 
@@ -116,7 +186,7 @@
 
 ### dbutils-get-performance
 
-يحصل على مقاييس أداء قاعدة البيانات.
+يسترجع مقاييس الأداء لاتصال قاعدة البيانات، بما في ذلك عدد الاستعلامات ومتوسط وقت التنفيذ واستخدام الذاكرة وإحصاءات الأخطاء. هذه المعلومات قيمة لمراقبة صحة قاعدة البيانات وتحديد نقاط الاختناق المحتملة.
 
 **مثال على التفاعل**:
 
@@ -130,7 +200,7 @@
 
 ### dbutils-analyze-query
 
-يحلل أداء استعلام SQL ويقدم اقتراحات للتحسين.
+يحلل خصائص أداء استعلام SQL، مع توفير خطة التنفيذ ووقت التنفيذ الفعلي وتوصيات محددة للتحسين. تتجاوز هذه الأداة التفسير البسيط من خلال تحديد المشكلات المحتملة واقتراح تحسينات ملموسة لتسريع تنفيذ الاستعلامات.
 
 **مثال على التفاعل**:
 

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/docs/es/usage.md

@@ -19,7 +19,7 @@ MCP Database Utilities proporciona varias herramientas que su IA puede usar:
 
 ### dbutils-list-connections
 
-Lista todas las conexiones de base de datos disponibles definidas en su configuración.
+Lista todas las conexiones de base de datos disponibles con información detallada, incluyendo tipo de base de datos, host, puerto y nombre de base de datos, mientras oculta información sensible como contraseñas. El parámetro opcional check_status permite verificar si cada conexión está disponible, aunque esto puede aumentar el tiempo de respuesta. Use esta herramienta cuando necesite entender los recursos de base de datos disponibles o diagnosticar problemas de conexión.
 
 **Ejemplo de Interacción**:
 
@@ -45,7 +45,7 @@ Lista todas las conexiones de base de datos disponibles definidas en su configur
 
 ### dbutils-list-tables
 
-Lista todas las tablas en la base de datos especificada.
+Lista todas las tablas en la conexión de base de datos especificada con nombres de tablas, URIs y descripciones disponibles, agrupadas por tipo de base de datos para fácil identificación. Esta herramienta es útil para explorar la estructura de la base de datos y entender qué tablas están disponibles para análisis.
 
 **Ejemplo de Interacción**:
 
@@ -60,7 +60,7 @@ Lista todas las tablas en la base de datos especificada.
 
 ### dbutils-run-query
 
-Ejecuta consultas SQL en la base de datos especificada (solo operaciones SELECT).
+Ejecuta consultas SQL de solo lectura (solo SELECT) en la base de datos especificada, con soporte para consultas complejas, incluyendo JOIN, GROUP BY y funciones de agregación, devolviendo resultados estructurados con nombres de columnas y filas de datos. Esta herramienta es esencial para extraer información específica de las bases de datos y realizar análisis personalizados.
 
 **Ejemplo de Interacción**:
 
@@ -68,9 +68,79 @@ Ejecuta consultas SQL en la base de datos especificada (solo operaciones SELECT)
 
 **IA**: "Verificaré eso para usted. Según los datos, ha habido 42 nuevos registros de clientes en los últimos 30 días."
 
+### dbutils-describe-table
+
+Proporciona información detallada sobre la estructura de una tabla, incluyendo nombres de columnas, tipos de datos, nulabilidad, valores predeterminados y comentarios en un formato fácil de leer. Esta herramienta es particularmente útil para entender el esquema de una tabla antes de ejecutar consultas o analizar datos.
+
+**Ejemplo de Interacción**:
+
+**Usted**: "Describe la estructura de la tabla clientes."
+
+**IA**: "Aquí está la estructura de la tabla clientes:
+| Columna | Tipo | Nullable | Predeterminado | Descripción |
+|---------|------|----------|----------------|-------------|
+| id | INTEGER | No | NULL | Identificador único del cliente |
+| nombre | VARCHAR(100) | No | NULL | Nombre completo del cliente |
+| email | VARCHAR(100) | No | NULL | Dirección de correo electrónico (única) |
+| fecha_registro | DATE | No | CURRENT_DATE | Fecha de registro |
+| ultimo_login | TIMESTAMP | Sí | NULL | Marca de tiempo del último inicio de sesión |
+| estado | ENUM | No | 'activo' | Estado de la cuenta (activo, inactivo, suspendido) |"
+
+### dbutils-get-ddl
+
+Recupera la declaración DDL (Lenguaje de Definición de Datos) completa para crear la tabla especificada, incluyendo todas las definiciones de columnas, restricciones e índices. Esta herramienta es útil para entender la definición exacta de una tabla o para recrear una estructura de tabla similar en otro entorno.
+
+**Ejemplo de Interacción**:
+
+**Usted**: "Muéstrame el DDL para la tabla pedidos."
+
+**IA**: "Aquí está la declaración DDL para la tabla pedidos:
+```sql
+CREATE TABLE pedidos (
+  order_id INT PRIMARY KEY AUTO_INCREMENT,
+  customer_id INT NOT NULL,
+  order_date DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  total_amount DECIMAL(10,2) NOT NULL CHECK (total_amount > 0),
+  status VARCHAR(20) NOT NULL DEFAULT 'pendiente',
+  FOREIGN KEY (customer_id) REFERENCES clientes(id)
+);
+
+CREATE INDEX idx_order_date ON pedidos(order_date);
+CREATE INDEX idx_customer_id ON pedidos(customer_id);
+```"
+
+### dbutils-list-indexes
+
+Lista todos los índices en la tabla especificada, incluyendo nombres de índices, tipos (único/no único), métodos de índice y columnas incluidas, agrupados por nombre de índice. Esta herramienta es útil para entender cómo está indexada una tabla, lo que puede ayudar a optimizar consultas y mejorar el rendimiento.
+
+**Ejemplo de Interacción**:
+
+**Usted**: "¿Qué índices existen en la tabla productos?"
+
+**IA**: "Aquí están los índices en la tabla productos:
+1. **pk_product_id** (Primario)
+   - Columnas: product_id
+   - Tipo: B-tree
+   - Único: Sí
+
+2. **idx_category** (Secundario)
+   - Columnas: category_id
+   - Tipo: B-tree
+   - Único: No
+
+3. **idx_product_name** (Secundario)
+   - Columnas: name
+   - Tipo: B-tree
+   - Único: No
+
+4. **idx_price_category** (Secundario)
+   - Columnas: price, category_id
+   - Tipo: B-tree
+   - Único: No"
+
 ### dbutils-get-stats
 
-Obtiene estadísticas sobre una tabla, como recuento de filas, tamaño y estadísticas de columnas.
+Recupera información estadística sobre la tabla, incluyendo recuento estimado de filas, longitud promedio de fila, tamaño de datos y tamaño de índice. Estas estadísticas son útiles para entender el volumen de datos y planificar optimizaciones de rendimiento.
 
 **Ejemplo de Interacción**:
 
@@ -86,7 +156,7 @@ Obtiene estadísticas sobre una tabla, como recuento de filas, tamaño y estadí
 
 ### dbutils-list-constraints
 
-Lista las restricciones para una tabla, como claves primarias, claves foráneas, etc.
+Lista todas las restricciones en la tabla, incluyendo claves primarias, claves foráneas, restricciones únicas y restricciones de verificación, con tablas y columnas referenciadas para claves foráneas. Esta herramienta es útil para entender las relaciones entre tablas y las reglas de integridad de datos.
 
 **Ejemplo de Interacción**:
 
@@ -100,7 +170,7 @@ Lista las restricciones para una tabla, como claves primarias, claves foráneas,
 
 ### dbutils-explain-query
 
-Obtiene el plan de ejecución de la consulta y estimaciones de costo.
+Proporciona el plan de ejecución para una consulta SQL, mostrando cómo el motor de base de datos procesará la consulta, incluyendo métodos de acceso, tipos de unión y costos estimados. Esta herramienta es esencial para entender y optimizar el rendimiento de consultas complejas.
 
 **Ejemplo de Interacción**:
 
@@ -114,7 +184,7 @@ Obtiene el plan de ejecución de la consulta y estimaciones de costo.
 
 ### dbutils-get-performance
 
-Obtiene métricas de rendimiento de la base de datos.
+Recupera métricas de rendimiento para la conexión de base de datos, incluyendo recuento de consultas, tiempo promedio de ejecución, uso de memoria y estadísticas de errores. Esta información es valiosa para monitorear la salud de la base de datos e identificar posibles cuellos de botella.
 
 **Ejemplo de Interacción**:
 
@@ -128,7 +198,7 @@ Obtiene métricas de rendimiento de la base de datos.
 
 ### dbutils-analyze-query
 
-Analiza el rendimiento de consultas SQL y proporciona sugerencias de optimización.
+Analiza las características de rendimiento de una consulta SQL, proporcionando plan de ejecución, tiempo real de ejecución y recomendaciones específicas de optimización. Esta herramienta va más allá de la explicación simple al identificar problemas potenciales y sugerir mejoras concretas para acelerar la ejecución de consultas.
 
 **Ejemplo de Interacción**:
 

{mcp_dbutils-0.21.0 → mcp_dbutils-0.22.0}/docs/fr/usage.md

@@ -19,7 +19,7 @@ MCP Database Utilities fournit plusieurs outils que votre IA peut utiliser :
 
 ### dbutils-list-connections
 
-Liste toutes les connexions de base de données disponibles définies dans votre configuration.
+Liste toutes les connexions de base de données disponibles avec des informations détaillées, notamment le type de base de données, l'hôte, le port et le nom de la base de données, tout en masquant les informations sensibles comme les mots de passe. Le paramètre optionnel check_status permet de vérifier si chaque connexion est disponible, bien que cela puisse augmenter le temps de réponse. Utilisez cet outil lorsque vous devez comprendre les ressources de base de données disponibles ou diagnostiquer des problèmes de connexion.
 
 **Exemple d'Interaction** :
 
@@ -45,7 +45,7 @@ Liste toutes les connexions de base de données disponibles définies dans votre
 
 ### dbutils-list-tables
 
-Liste toutes les tables dans la base de données spécifiée.
+Liste toutes les tables dans la connexion de base de données spécifiée avec les noms de tables, les URI et les descriptions disponibles, regroupées par type de base de données pour une identification facile. Cet outil est utile pour explorer la structure de la base de données et comprendre quelles tables sont disponibles pour l'analyse.
 
 **Exemple d'Interaction** :
 
@@ -60,7 +60,7 @@ Liste toutes les tables dans la base de données spécifiée.
 
 ### dbutils-run-query
 
-Exécute des requêtes SQL sur la base de données spécifiée (opérations SELECT uniquement).
+Exécute des requêtes SQL en lecture seule (SELECT uniquement) sur la base de données spécifiée, avec prise en charge de requêtes complexes, notamment JOIN, GROUP BY et fonctions d'agrégation, renvoyant des résultats structurés avec des noms de colonnes et des lignes de données. Cet outil est essentiel pour extraire des informations spécifiques des bases de données et effectuer des analyses personnalisées.
 
 **Exemple d'Interaction** :
 
@@ -68,9 +68,79 @@ Exécute des requêtes SQL sur la base de données spécifiée (opérations SELE
 
 **IA** : "Laissez-moi vérifier cela pour vous. Selon les données, il y a eu 42 nouvelles inscriptions de clients au cours des 30 derniers jours."
 
+### dbutils-describe-table
+
+Fournit des informations détaillées sur la structure d'une table, notamment les noms de colonnes, les types de données, la nullabilité, les valeurs par défaut et les commentaires dans un format facile à lire. Cet outil est particulièrement utile pour comprendre le schéma d'une table avant d'exécuter des requêtes ou d'analyser des données.
+
+**Exemple d'Interaction** :
+
+**Vous** : "Décrivez la structure de la table clients."
+
+**IA** : "Voici la structure de la table clients :
+| Colonne | Type | Nullable | Défaut | Description |
+|---------|------|----------|--------|-------------|
+| id | INTEGER | Non | NULL | Identifiant unique du client |
+| nom | VARCHAR(100) | Non | NULL | Nom complet du client |
+| email | VARCHAR(100) | Non | NULL | Adresse email (unique) |
+| date_inscription | DATE | Non | CURRENT_DATE | Date d'inscription |
+| derniere_connexion | TIMESTAMP | Oui | NULL | Horodatage de la dernière connexion |
+| statut | ENUM | Non | 'actif' | Statut du compte (actif, inactif, suspendu) |"
+
+### dbutils-get-ddl
+
+Récupère l'instruction DDL (Data Definition Language) complète pour créer la table spécifiée, y compris toutes les définitions de colonnes, contraintes et index. Cet outil est utile pour comprendre la définition exacte d'une table ou pour recréer une structure de table similaire dans un autre environnement.
+
+**Exemple d'Interaction** :
+
+**Vous** : "Montrez-moi le DDL pour la table commandes."
+
+**IA** : "Voici l'instruction DDL pour la table commandes :
+```sql
+CREATE TABLE commandes (
+  order_id INT PRIMARY KEY AUTO_INCREMENT,
+  customer_id INT NOT NULL,
+  order_date DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  total_amount DECIMAL(10,2) NOT NULL CHECK (total_amount > 0),
+  status VARCHAR(20) NOT NULL DEFAULT 'en attente',
+  FOREIGN KEY (customer_id) REFERENCES clients(id)
+);
+
+CREATE INDEX idx_order_date ON commandes(order_date);
+CREATE INDEX idx_customer_id ON commandes(customer_id);
+```"
+
+### dbutils-list-indexes
+
+Liste tous les index sur la table spécifiée, y compris les noms d'index, les types (unique/non unique), les méthodes d'index et les colonnes incluses, regroupés par nom d'index. Cet outil est utile pour comprendre comment une table est indexée, ce qui peut aider à optimiser les requêtes et à améliorer les performances.
+
+**Exemple d'Interaction** :
+
+**Vous** : "Quels index existent sur la table produits ?"
+
+**IA** : "Voici les index sur la table produits :
+1. **pk_product_id** (Primaire)
+   - Colonnes : product_id
+   - Type : B-tree
+   - Unique : Oui
+
+2. **idx_category** (Secondaire)
+   - Colonnes : category_id
+   - Type : B-tree
+   - Unique : Non
+
+3. **idx_product_name** (Secondaire)
+   - Colonnes : name
+   - Type : B-tree
+   - Unique : Non
+
+4. **idx_price_category** (Secondaire)
+   - Colonnes : price, category_id
+   - Type : B-tree
+   - Unique : Non"
+
 ### dbutils-get-stats
 
-Obtient des statistiques sur une table, telles que le nombre de lignes, la taille et les statistiques de colonnes.
+Récupère des informations statistiques sur la table, notamment le nombre estimé de lignes, la longueur moyenne des lignes, la taille des données et la taille de l'index. Ces statistiques sont utiles pour comprendre la volumétrie des données et planifier des optimisations de performance.
 
 **Exemple d'Interaction** :
 
@@ -86,7 +156,7 @@ Obtient des statistiques sur une table, telles que le nombre de lignes, la taill
 
 ### dbutils-list-constraints
 
-Liste les contraintes pour une table, telles que les clés primaires, les clés étrangères, etc.
+Liste toutes les contraintes sur la table, y compris les clés primaires, les clés étrangères, les contraintes uniques et les contraintes de vérification, avec les tables et colonnes référencées pour les clés étrangères. Cet outil est utile pour comprendre les relations entre les tables et les règles d'intégrité des données.
 
 **Exemple d'Interaction** :
 
@@ -100,7 +170,7 @@ Liste les contraintes pour une table, telles que les clés primaires, les clés
 
 ### dbutils-explain-query
 
-Obtient le plan d'exécution de la requête et les estimations de coût.
+Fournit le plan d'exécution d'une requête SQL, montrant comment le moteur de base de données traitera la requête, y compris les méthodes d'accès, les types de jointure et les coûts estimés. Cet outil est essentiel pour comprendre et optimiser les performances des requêtes complexes.
 
 **Exemple d'Interaction** :
 
@@ -114,7 +184,7 @@ Obtient le plan d'exécution de la requête et les estimations de coût.
 
 ### dbutils-get-performance
 
-Obtient des métriques de performance de la base de données.
+Récupère les métriques de performance pour la connexion à la base de données, notamment le nombre de requêtes, le temps d'exécution moyen, l'utilisation de la mémoire et les statistiques d'erreur. Ces informations sont précieuses pour surveiller la santé de la base de données et identifier les goulots d'étranglement potentiels.
 
 **Exemple d'Interaction** :
 
@@ -128,7 +198,7 @@ Obtient des métriques de performance de la base de données.
 
 ### dbutils-analyze-query
 
-Analyse les performances des requêtes SQL et fournit des suggestions d'optimisation.
+Analyse les caractéristiques de performance d'une requête SQL, fournissant un plan d'exécution, un temps d'exécution réel et des recommandations d'optimisation spécifiques. Cet outil va au-delà de l'explication simple en identifiant les problèmes potentiels et en suggérant des améliorations concrètes pour accélérer l'exécution des requêtes.
 
 **Exemple d'Interaction** :