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

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

@@ -1,3 +1,17 @@
+# [0.23.0](https://github.com/donghao1393/mcp-dbutils/compare/v0.22.0...v0.23.0) (2025-05-03)
+
+
+### Features
+
+* 升级MCP SDK从v1.2.1到v1.7.1 ([#85](https://github.com/donghao1393/mcp-dbutils/issues/85)) ([f0c4f9f](https://github.com/donghao1393/mcp-dbutils/commit/f0c4f9f6b99de4febb53b80a7036bd88b1d6dd39))
+
+# [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.23.0}/PKG-INFO

@@ -1,16 +1,17 @@
 Metadata-Version: 2.4
 Name: mcp-dbutils
-Version: 0.21.0
+Version: 0.23.0
 Summary: MCP Database Utilities Service
 Author: Dong Hao
 License-Expression: MIT
 License-File: LICENSE
 Requires-Python: >=3.10
-Requires-Dist: mcp>=1.2.1
+Requires-Dist: mcp>=1.7.1
 Requires-Dist: mysql-connector-python>=8.2.0
 Requires-Dist: psycopg2-binary>=2.9.10
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: typer>=0.9.0
 Provides-Extra: test
 Requires-Dist: aiosqlite>=0.19.0; extra == 'test'
 Requires-Dist: docker>=7.0.0; extra == 'test'

{mcp_dbutils-0.21.0 → mcp_dbutils-0.23.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.23.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.23.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.23.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).
 
 ## Документация