Использование MCP-сервера ClickHouse с Claude Desktop

В этом руководстве рассказывается, как настроить Claude Desktop для работы с MCP-сервером ClickHouse с помощью uv и подключить его к примерам наборов данных ClickHouse.

Установка uv

Чтобы выполнить инструкции из этого руководства, вам потребуется установить uv. Если вы не хотите использовать uv, вам нужно будет изменить конфигурацию MCP-сервера и указать альтернативный менеджер пакетов.

Загрузка Claude Desktop

Вам также потребуется установить приложение Claude Desktop, которое можно скачать на сайте Claude Desktop.

Настройка MCP-сервера ClickHouse

После установки Claude Desktop можно переходить к настройке MCP-сервера ClickHouse. Это можно сделать через файл конфигурации Claude Desktop.Чтобы найти этот файл, сначала откройте страницу настроек (Cmd+, на Mac), а затем нажмите вкладку Developer в меню слева. После этого вы увидите следующий экран, где нужно нажать кнопку Edit config:Вы попадёте в каталог, содержащий файл конфигурации (claude_desktop_config.json). При первом открытии этого файла он, скорее всего, будет содержать следующее:

{
  "mcpServers": {}
}

Словарь mcpServers использует имя MCP-сервера в качестве ключа, а словарь параметров конфигурации — в качестве значения. Например, конфигурация MCP-сервера ClickHouse для подключения к Песочнице ClickHouse будет выглядеть так:

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": "",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

После обновления конфигурации вам нужно будет перезапустить Claude Desktop, чтобы изменения вступили в силу.

В зависимости от того, как вы установили uv, при перезапуске Claude Desktop может появиться следующая ошибка:

MCP mcp-clickhouse: spawn uv ENOENT

Если это произойдёт, вам нужно будет изменить command, указав полный путь к uv. Например, если вы устанавливали его через Cargo, путь будет таким: /Users/<username>/.cargo/bin/uv

Использование MCP-сервера ClickHouse

После перезапуска Claude Desktop вы сможете найти MCP-сервер ClickHouse, нажав на значок Search and tools:
Затем можно выбрать, отключить все инструменты или только некоторые из них.Теперь всё готово, чтобы задавать Claude вопросы, при ответе на которые он будет использовать MCP-сервер ClickHouse. Например, можно спросить: What's the most interesting dataset in the SQL playground?.При первом обращении к инструменту Claude попросит подтвердить использование каждого инструмента MCP-сервера:Ниже показана часть диалога, включающего несколько вызовов инструментов MCP-сервера ClickHouse:

Последнее изменение 23 июля 2026 г.

Интеграция с LibreChatВ этом руководстве показано, как настроить LibreChat с MCP-сервером ClickHouse с помощью Docker.