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

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

Установка uv

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

Скачивание 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 в качестве ключа и словарь параметров конфигурации в качестве значения.
Например, конфигурация сервера ClickHouse MCP, подключающаяся к 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