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

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

Установка uv

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

Загрузите Claude Desktop

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

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

После установки Claude Desktop можно переходить к настройке сервера ClickHouse MCP. Сделать это можно через файл конфигурации Claude Desktop.

Чтобы найти этот файл, сначала откройте страницу настроек (Cmd+, на Mac), затем нажмите на вкладку Developer в левом меню. После этого вы увидите следующий экран, на котором нужно нажать кнопку Edit config:

Вы попадёте в каталог, содержащий файл конфигурации (claude_desktop_config.json). При первом открытии этот файл, скорее всего, будет иметь примерно следующее содержание:

{
  "mcpServers": {}
}

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

{
  "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