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

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

@@ -1,3 +1,17 @@
+# [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)
+
+
+### Features
+
+* 优化数据库工具描述以提高LLM理解能力 ([#81](https://github.com/donghao1393/mcp-dbutils/issues/81)) ([232cd3e](https://github.com/donghao1393/mcp-dbutils/commit/232cd3ed247ed95248932001c99ed529819cddf8))
+
 ## [0.20.1](https://github.com/donghao1393/mcp-dbutils/compare/v0.20.0...v0.20.1) (2025-04-30)
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-dbutils
-Version: 0.20.1
+Version: 0.22.0
 Summary: MCP Database Utilities Service
 Author: Dong Hao
 License-Expression: MIT
@@ -125,14 +125,17 @@ MCP Database Utilities 是一个多功能的 MCP 服务，它使您的 AI 能够
 
 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**：分析查询以进行优化
+- **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/zh/usage.md)。
 

{mcp_dbutils-0.20.1 → mcp_dbutils-0.22.0}/README.md

@@ -100,14 +100,17 @@ MCP Database Utilities 是一个多功能的 MCP 服务，它使您的 AI 能够
 
 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**：分析查询以进行优化
+- **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/zh/usage.md)。
 

{mcp_dbutils-0.20.1 → 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.20.1 → mcp_dbutils-0.22.0}/README_EN.md

@@ -73,14 +73,19 @@ We offer multiple installation methods, including uvx, Docker, and Smithery. For
 
 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
+- **dbutils-list-connections**: Lists all available database connections with detailed information including database type, host, port, and database name, while hiding sensitive information like passwords.
+- **dbutils-list-tables**: Lists all tables in the specified database connection with table names, URIs, and available descriptions, grouped by database type for easy identification.
+- **dbutils-run-query**: Executes read-only SQL queries (SELECT only) with support for complex queries including JOINs, GROUP BY, and aggregate functions, returning structured results with column names and data rows.
+- **dbutils-describe-table**: Provides detailed information about a table's structure, including column names, data types, nullability, default values, and comments in an easy-to-read format.
+- **dbutils-get-ddl**: Retrieves the complete DDL (Data Definition Language) statement for creating the specified table, including all column definitions, constraints, and indexes.
+- **dbutils-list-indexes**: Lists all indexes on the specified table, including index names, types (unique/non-unique), index methods, and included columns, grouped by index name.
+- **dbutils-get-stats**: Retrieves statistical information about the table, including estimated row count, average row length, data size, and index size.
+- **dbutils-list-constraints**: Lists all constraints on the table, including primary keys, foreign keys, unique constraints, and check constraints, with referenced tables and columns for foreign keys.
+- **dbutils-explain-query**: Provides the execution plan for a SQL query, showing how the database engine will process the query, including access methods, join types, and estimated costs.
+- **dbutils-get-performance**: Retrieves performance metrics for the database connection, including query count, average execution time, memory usage, and error statistics.
+- **dbutils-analyze-query**: Analyzes the performance characteristics of a SQL query, providing execution plan, actual execution time, and specific optimization recommendations.
+
+For detailed descriptions and usage examples of these tools, see the [Usage Guide](docs/en/usage.md).
 
 
 

{mcp_dbutils-0.20.1 → 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.20.1 → 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.20.1 → 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.20.1 → 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.20.1 → mcp_dbutils-0.22.0}/docs/en/usage.md

@@ -1,8 +1,5 @@
 # Usage Guide
 
-*English | [中文](../zh/usage.md) | [Français](../fr/usage.md) | [Español](../es/usage.md) | [العربية](../ar/usage.md) | [Русский](../ru/usage.md)*
-
-
 *English | [中文](../zh/usage.md) | [Français](../fr/usage.md) | [Español](../es/usage.md) | [العربية](../ar/usage.md) | [Русский](../ru/usage.md)*
 
 This document provides detailed instructions for using the MCP Database Utilities, helping you fully leverage its capabilities for data analysis with AI.
@@ -22,7 +19,7 @@ MCP Database Utilities provides several tools that your AI can use:
 
 ### dbutils-list-connections
 
-Lists all available database connections defined in your configuration.
+Lists all available database connections defined in the configuration with detailed information including database type, host, port, and database name, while hiding sensitive information like passwords. The optional check_status parameter allows verifying if each connection is available, though this may increase response time. Use this tool when you need to understand available database resources or diagnose connection issues.
 
 **Example Interaction**:
 
@@ -48,7 +45,7 @@ Lists all available database connections defined in your configuration.
 
 ### dbutils-list-tables
 
-Lists all tables in the specified database.
+Lists all tables in the specified database connection with table names, URIs, and available descriptions. Results are grouped by database type and clearly labeled for easy identification. Use this tool when you need to understand database structure or locate specific tables. Only works within the allowed connection scope.
 
 **Example Interaction**:
 
@@ -63,7 +60,7 @@ Lists all tables in the specified database.
 
 ### dbutils-run-query
 
-Executes SQL queries on the specified database (SELECT operations only).
+Executes read-only SQL queries on the specified database connection. For security, only SELECT statements are supported. Returns structured results with column names and data rows. Supports complex queries including JOINs, GROUP BY, ORDER BY, and aggregate functions. Use this tool when you need to analyze data, validate hypotheses, or extract specific information. Query execution is protected by resource limits and timeouts to prevent system resource overuse.
 
 **Example Interaction**:
 
@@ -71,9 +68,49 @@ Executes SQL queries on the specified database (SELECT operations only).
 
 **AI**: "Let me check that for you. According to the data, there have been 42 new customer registrations in the last 30 days."
 
+### dbutils-describe-table
+
+Provides detailed information about a table's structure, including column names, data types, nullability, default values, and comments. Results are formatted as an easy-to-read hierarchy that clearly displays all column attributes. Use this tool when you need to understand table structure in depth, analyze data models, or prepare queries. Supports all major database types with consistent output format.
+
+**Example Interaction**:
+
+**You**: "Describe the structure of the customers table."
+
+**AI**: "The customers table has the following structure:
+- id: integer, primary key, not null, auto-increment
+- name: varchar(100), not null
+- email: varchar(100), unique, not null
+- registration_date: date, not null, default: current_date
+- status: enum('active','inactive','suspended'), default: 'active'
+- last_login: timestamp, nullable"
+
+### dbutils-get-ddl
+
+Retrieves the complete DDL (Data Definition Language) statement for creating the specified table. Returns the original CREATE TABLE statement including all column definitions, constraints, indexes, and table options. This tool is valuable when you need to understand the complete table structure, replicate table structure, or perform database migrations. Note that DDL statement format varies by database type.
+
+**Example Interaction**:
+
+**You**: "Get the DDL for the products table."
+
+**AI**: "Here's the DDL statement for the products table:
+```sql
+CREATE TABLE products (
+  id INT NOT NULL AUTO_INCREMENT,
+  name VARCHAR(200) NOT NULL,
+  description TEXT,
+  price DECIMAL(10,2) NOT NULL,
+  category_id INT,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  PRIMARY KEY (id),
+  INDEX idx_category (category_id),
+  CONSTRAINT fk_category FOREIGN KEY (category_id) REFERENCES categories(id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+```"
+
 ### dbutils-get-stats
 
-Gets statistics about a table, such as row count, size, and column statistics.
+Retrieves statistical information about the table, including estimated row count, average row length, data size, index size, and column information. These statistics are valuable for understanding table size, growth trends, and storage characteristics. Use this tool when you need to perform capacity planning, performance optimization, or database maintenance. Note that the precision and availability of statistics may vary by database type.
 
 **Example Interaction**:
 
@@ -87,9 +124,38 @@ Gets statistics about a table, such as row count, size, and column statistics.
   * category: 8 distinct categories
   * price: average $45.99, min $5.99, max $299.99"
 
+### dbutils-list-indexes
+
+Lists all indexes on the specified table, including index names, types (unique/non-unique), index methods (e.g., B-tree), and included columns. Results are grouped by index name, clearly showing the structure of multi-column indexes. Use this tool when you need to optimize query performance, understand table access patterns, or diagnose performance issues.
+
+**Example Interaction**:
+
+**You**: "List all indexes on the orders table."
+
+**AI**: "The orders table has the following indexes:
+1. **PRIMARY** (Primary Key Index)
+   - Column: order_id
+   - Type: Unique
+   - Method: B-tree
+
+2. **idx_customer** (Regular Index)
+   - Column: customer_id
+   - Type: Non-unique
+   - Method: B-tree
+
+3. **idx_order_date** (Regular Index)
+   - Column: order_date
+   - Type: Non-unique
+   - Method: B-tree
+
+4. **idx_status_created** (Composite Index)
+   - Columns: status, created_at
+   - Type: Non-unique
+   - Method: B-tree"
+
 ### dbutils-list-constraints
 
-Lists constraints for a table, such as primary keys, foreign keys, etc.
+Lists all constraints on the table, including primary keys, foreign keys, unique constraints, and check constraints. Results are grouped by constraint type, clearly showing constraint names and involved columns. For foreign key constraints, referenced tables and columns are also displayed. Use this tool when you need to understand data integrity rules, table relationships, or data validation logic.
 
 **Example Interaction**:
 
@@ -103,7 +169,7 @@ Lists constraints for a table, such as primary keys, foreign keys, etc.
 
 ### dbutils-explain-query
 
-Gets the query execution plan and cost estimates.
+Provides the execution plan for a SQL query, showing how the database engine will process the query. Returns detailed execution plan including access methods, join types, sort operations, and estimated costs. Also provides actual execution statistics where available. Use this tool when you need to optimize query performance, understand complex query behavior, or diagnose slow queries. Note that execution plan format varies by database type.
 
 **Example Interaction**:
 
@@ -117,7 +183,7 @@ Gets the query execution plan and cost estimates.
 
 ### dbutils-get-performance
 
-Gets database performance metrics.
+Retrieves performance metrics for the database connection, including query count, average execution time, memory usage, and error statistics. These metrics reflect the resource usage of the current session and help monitor and optimize database operations. Use this tool when you need to evaluate query efficiency, identify performance bottlenecks, or monitor resource usage.
 
 **Example Interaction**:
 
@@ -131,7 +197,7 @@ Gets database performance metrics.
 
 ### dbutils-analyze-query
 
-Analyzes SQL query performance and provides optimization suggestions.
+Analyzes the performance characteristics of a SQL query, providing execution plan, actual execution time, and optimization suggestions. The tool executes the query (SELECT statements only) and measures performance, then provides specific optimization recommendations based on the results, such as adding indexes, restructuring join conditions, or adjusting query structure. Use this tool when you need to improve query performance, understand performance bottlenecks, or learn query optimization techniques.
 
 **Example Interaction**: