mcp-clickhouse

Добавлена поддержка именованных параметров запросов и клиентских TLS-сертификатов, обновлены зависимости и улучшена производительность health-check.

• НовоеДобавлена поддержка именованных параметров {name:Type} в run_query для скалярных значений и массивов.
• НовоеРеализована поддержка клиентских TLS-сертификатов и частных CA-бандлов для HTTPS-подключений к ClickHouse.
• Ломает совместимостьТребование clickhouse-connect >=1.0.0; параметры TLS теперь задаются как верхнеуровневые опции, а не через generic_args или DSN.
• ИсправленоКэширование результатов проверки здоровья (/health) на 1 секунду для снижения нагрузки на базу данных.
• УстарелоУдалены внутренние импорты Table, execute_query и QUERY_EXECUTOR из mcp_clickhouse.mcp_server.

Переход на FastMCP 4 и поддержку MCP 2026-07-28, оптимизация метаданных и исправление ошибок пагинации.

• НовоеДобавлена поддержка протокола MCP 2026-07-28, включая server/discover и кэширование ответов.
• Ломает совместимостьВнедрены изменения для совместимости с FastMCP 4, требующие обновления кастомного middleware.
• УстарелоСтандартный HTTP+SSE транспорт объявлен устаревшим, рекомендуется использовать Streamable HTTP.
• ИсправленоИсправлены гонки токенов пагинации и сохранение курсоров при сбоях и отмене запросов.
• НовоеМетаданные теперь обрабатываются в отдельном потоке, чтобы не задерживать выполнение запросов.

Релиз v0.5.0: усиление безопасности HTTP, защита от DNS-ребиндинга, кэширование клиентов и новые ограничения на разрушительные запросы.

• Ломает совместимостьДобавлена валидация заголовков Host и Origin по умолчанию; для wildcard-биндов требуется настройка CLICKHOUSE_MCP_ALLOWED_HOSTS.
• Ломает совместимостьПеременная CLICKHOUSE_ALLOW_DROP теперь также ограничивает операции DELETE, UPDATE, удаление партиций и столбцов.
• НовоеРеализована защита от DNS-ребиндинга для HTTP, SSE и режимов запуска fastmcp.
• НовоеКлиенты ClickHouse переиспользуются между вызовами инструментов, добавлена серверная отмена запросов по таймауту.
• ИсправленоБольшие целые числа возвращаются как строки для избежания ошибок точности в JavaScript.

Релиз v0.4.1: добавлена поддержка официальных навыков агентов через FastMCP и публикация в MCP Registry.

• НовоеВнедрены официальные навыки агентов ClickHouse через инструкции уровня сервера FastMCP, заменившие старую систему рекомендаций на основе инструментов.
• НовоеПакет mcp-clickhouse опубликован в официальном MCP Registry (registry.modelcontextprotocol.io) и синхронизирован с репозиторием github.com/mcp.

Релиз v0.4.0: добавлена поддержка OAuth/OIDC, опубликованы официальные образы GHCR и исправлены проблемы с конкурентностью запросов.

• НовоеДобавлена аутентификация OAuth/OIDC для HTTP/SSE транспортов (Azure Entra, Google, GitHub, WorkOS).
• НовоеОфициальные мультиархитектурные Docker-образы теперь публикуются в GHCR.
• Ломает совместимостьРежимы аутентификации стали взаимоисключающими: можно использовать только один.
• Ломает совместимостьОтветы инструментов теперь возвращаются в виде JSON-строк, а не сырых словарей.
• ИсправленоДолго выполняемые запросы больше не блокируют выполнение других инструментов.