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

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

Установка uv

Чтобы следовать инструкциям в этом руководстве, вам потребуется установить uv. Если вы не хотите использовать uv, вам потребуется обновить config 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 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