Перейти к основному содержимому
Перейти к основному содержимому

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

В этом руководстве описано, как использовать сервер ClickHouse MCP с Ollama.

Установите Ollama​

Ollama — это библиотека для запуска больших языковых моделей (LLM) на вашей машине. Она имеет широкий спектр доступных моделей и проста в использовании.

Вы можете загрузить Ollama для Mac, Windows или Linux со страницы загрузки.

После запуска Ollama запустит локальный сервер в фоновом режиме, который можно использовать для запуска моделей. Также вы можете запустить сервер вручную, выполнив команду ollama serve.

После установки вы можете загрузить модель на свой компьютер следующим образом:

ollama pull qwen3:8b

Это загрузит модель на локальную машину, если она ещё не установлена. После загрузки вы можете запустить модель следующим образом:

ollama run qwen3:8b
Примечание

С MCP-серверами будут работать только модели с поддержкой инструментов.

Вывести список загруженных моделей можно следующим образом:

ollama ls

NAME                       ID              SIZE      MODIFIED
qwen3:latest               500a1f067a9f    5.2 GB    3 days ago

Для получения дополнительной информации о загруженной модели можно использовать следующую команду:

ollama show qwen3

  Model
    architecture        qwen3
    parameters          8.2B
    context length      40960
    embedding length    4096
    quantization        Q4_K_M

  Capabilities
    completion
    tools

  Parameters
    repeat_penalty    1
    stop              "<|im_start|>"
    stop              "<|im_end|>"
    temperature       0.6
    top_k             20
    top_p             0.95

  License
    Apache License
    Version 2.0, January 2004

Из этого вывода видно, что модель qwen3 по умолчанию имеет чуть более 8 миллиардов параметров.

Установка MCPHost​

На момент написания (июль 2025 года) нет встроенной функциональности для использования Ollama с MCP-серверами. Однако можно использовать MCPHost для запуска моделей Ollama с MCP-серверами.

MCPHost — это приложение на Go, поэтому вам необходимо убедиться, что на вашей машине установлен Go. После этого вы можете установить MCPHost, выполнив следующую команду:

go install github.com/mark3labs/mcphost@latest

Исполняемый файл будет установлен в каталог ~/go/bin, поэтому необходимо убедиться, что этот каталог добавлен в переменную PATH.

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

MCP-серверы можно настроить с помощью MCPHost в файлах YAML или JSON. MCPHost будет искать файлы конфигурации в вашем домашнем каталоге в следующем порядке:

  1. .mcphost.yml или .mcphost.json (рекомендуется)
  2. .mcp.yml или .mcp.json (для обратной совместимости)

Он использует синтаксис, аналогичный тому, который применяется в стандартном файле конфигурации MCP. Вот пример конфигурации сервера ClickHouse MCP, который мы сохраним в файл ~/.mcphost.json:

{
  "mcpServers": {
    "mcp-ch": {
      "type": "local",
      "command": ["uv",
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ]
    }
  }
}

Основное отличие от стандартного файла конфигурации MCP заключается в том, что необходимо указать параметр type. Этот параметр используется для указания типа транспорта, используемого MCP-сервером.

  • local → транспорт stdio
  • remote → транспорт с потоковой передачей данных
  • builtin → внутрипроцессный транспорт

Нам также потребуется настроить следующие переменные окружения:

export CLICKHOUSE_HOST=sql-clickhouse.clickhouse.com
export CLICKHOUSE_USER=demo
export CLICKHOUSE_PASSWORD=""
Примечание

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

Запуск MCPHost​

После того как вы настроили сервер ClickHouse MCP, вы можете запустить MCPHost, выполнив следующую команду:

mcphost --model ollama:qwen3

Или, если вы хотите использовать определённый файл конфигурации:

mcphost --model ollama:qwen3 --config ~/.mcphost.json
Примечание

Если вы не укажете параметр --model, MCPHost будет искать в переменных окружения ANTHROPIC_API_KEY и использовать модель anthropic:claude-sonnet-4-20250514.

Вы должны увидеть следующий вывод:

  ┃                                                                                     ┃
  ┃  Model loaded: ollama (qwen3)                                                       ┃
  ┃   MCPHost System (09:52)                                                            ┃
  ┃                                                                                     ┃

  ┃                                                                                     ┃
  ┃  Model loaded successfully on GPU                                                   ┃
  ┃   MCPHost System (09:52)                                                            ┃
  ┃                                                                                     ┃

  ┃                                                                                     ┃
  ┃  Loaded 3 tools from MCP servers                                                    ┃
  ┃   MCPHost System (09:52)                                                            ┃
  ┃                                                                                     ┃

  Enter your prompt (Type /help for commands, Ctrl+C to quit, ESC to cancel generation)

Мы можем использовать команду /servers, чтобы вывести список MCP-серверов:

  ┃                                                                                      ┃
  ┃  ## Configured MCP Servers                                                           ┃
  ┃                                                                                      ┃
  ┃  1. mcp-ch                                                                           ┃
  ┃   MCPHost System (10:00)                                                             ┃
  ┃

А команду /tools — чтобы вывести список доступных инструментов:

  ┃  ## Available Tools                                                                  ┃
  ┃                                                                                      ┃
  ┃  1. mcp-ch__list_databases                                                           ┃
  ┃  2. mcp-ch__list_tables                                                              ┃
  ┃  3. mcp-ch__run_select_query

После этого мы можем задавать модели вопросы о базах данных и таблицах, доступных в песочнице ClickHouse SQL.

По нашему опыту, при использовании более компактных моделей (модель qwen3 по умолчанию имеет 8 миллиардов параметров) вам нужно более точно формулировать, что вы хотите, чтобы модель сделала. Например, вам нужно будет явно попросить её вывести список баз данных и таблиц, а не сразу просить выполнить запрос к определённой таблице. Частично уменьшить эту проблему можно, используя более крупную модель (например, qwen3:14b), но она будет работать медленнее на пользовательском оборудовании.