Ollama MCP: сервер для локальных моделей в Claude Code, Codex и Cursor

rawveg/ollama-mcp· Проверено 12.11.2026· 178на GitHub

Даёт агенту доступ к моделям Ollama: скачать или удалить модель, задать вопрос локальной модели, получить эмбеддинги. С ключом Ollama Cloud добавляются облачные модели, веб-поиск и загрузка страниц.

2 реализации:

Пакет из npm на 13 инструментов поверх Ollama SDK: локальные и облачные модели в одном сервере, эмбеддинги, веб-поиск через Ollama Cloud.

Как подключить

Что сделать до подключения

Node.js с командой npx

Запущенная Ollama на компьютере или ключ Ollama Cloud

OLLAMA_API_KEY

нужен только для облачных моделей, ollama_web_search и ollama_web_fetch: зарегистрируйтесь на ollama.com и получите ключ

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env OLLAMA_HOST=http://127.0.0.1:11434 --transport stdio ollama \
  -- npx -y ollama-mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.ollama]
command = "npx"
args = ["-y", "ollama-mcp"]

[mcp_servers.ollama.env]
OLLAMA_HOST = "http://127.0.0.1:11434"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "ollama": {
      "command": "npx",
      "args": ["-y", "ollama-mcp"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "ollama": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ollama-mcp"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

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

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "ollama": {
      "command": "npx",
      "args": ["-y", "ollama-mcp"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "ollama": {
      "command": "npx",
      "args": ["-y", "ollama-mcp"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ollama": {
        "type": "local",
        "command": ["npx", "-y", "ollama-mcp"],
        "environment": {
          "OLLAMA_HOST": "http://127.0.0.1:11434"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "ollama": {
      "command": "npx",
      "args": ["-y", "ollama-mcp"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "ollama": {
      "command": "npx",
      "args": ["-y", "ollama-mcp"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

ollama_listпоказывает локальные модели

ollama_showчитает сведения о модели

ollama_pullскачивает модель из библиотеки

ollama_pushотправляет модель в библиотеку

ollama_copyкопирует модель

ollama_deleteудаляет модель с диска

ollama_createсобирает модель из Modelfile

ollama_psпоказывает запущенные модели

ollama_generateгенерирует текст по промпту

ollama_chatведёт диалог с моделью

ollama_embedсчитает эмбеддинги текста

ollama_web_searchищет в интернете

ollama_web_fetchзагружает и разбирает страницу

Ставится сборкой из исходников и работает с локальной Ollama: умеет запускать сервер Ollama и отдаёт чат в формате OpenAI с ролями system, user и assistant.

Как подключить

Что сделать до подключения

Установленная Ollama

Node.js и pnpm: склонировать репозиторий, выполнить pnpm install и pnpm run build

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env OLLAMA_HOST=http://127.0.0.1:11434 --transport stdio ollama-mcp \
  -- node /путь/к/Ollama-mcp/build/index.js

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.ollama-mcp]
command = "node"
args = ["/путь/к/Ollama-mcp/build/index.js"]

[mcp_servers.ollama-mcp.env]
OLLAMA_HOST = "http://127.0.0.1:11434"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "ollama-mcp": {
      "command": "node",
      "args": ["/путь/к/Ollama-mcp/build/index.js"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "ollama-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/путь/к/Ollama-mcp/build/index.js"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "ollama-mcp": {
      "command": "node",
      "args": ["/путь/к/Ollama-mcp/build/index.js"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "ollama-mcp": {
      "command": "node",
      "args": ["/путь/к/Ollama-mcp/build/index.js"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "ollama-mcp": {
        "type": "local",
        "command": ["node", "/путь/к/Ollama-mcp/build/index.js"],
        "environment": {
          "OLLAMA_HOST": "http://127.0.0.1:11434"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "ollama-mcp": {
      "command": "node",
      "args": ["/путь/к/Ollama-mcp/build/index.js"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "ollama-mcp": {
      "command": "node",
      "args": ["/путь/к/Ollama-mcp/build/index.js"],
      "env": {
        "OLLAMA_HOST": "http://127.0.0.1:11434"
      }
    }
  }
}

Инструменты сервера

serveзапускает сервер Ollama

listпоказывает модели

showчитает сведения о модели

pullскачивает модель

pushотправляет модель в реестр

createсобирает модель из Modelfile

cpкопирует модель

rmудаляет модель

runзапускает модель с промптом

chat_completionотвечает в формате OpenAI

Что попросить агента

«Спроси модель <llama3.2:latest>: <вопрос>»rawveg вызовет ollama_chat с выбранной моделью и вернёт её ответ

«Посчитай эмбеддинги для строк <список> моделью nomic-embed-text»rawveg вызовет ollama_embed со списком строк

«Найди в интернете <запрос>, 5 результатов»rawveg вызовет ollama_web_search с max_results 5, нужен ключ Ollama Cloud

«Скачай модель <llama2> и попроси её объяснить <тема> простыми словами»NightTrek вызовет pull, затем run с промптом

«Создай модель <имя> из Modelfile <путь>»Агент вызовет ollama_create у rawveg или create у NightTrek

Для каких задач

Передать часть задачи локальной модели через чат или генерацию текста

Скачать модель из библиотеки Ollama и посмотреть её параметры

Посчитать эмбеддинги текста, например моделью nomic-embed-text

Собрать свою модель из Modelfile

Посмотреть, какие модели скачаны и какие сейчас запущены

Поискать в интернете и загрузить страницу через Ollama Cloud

Ограничения

Веб-поиск, загрузка страниц и облачные модели в rawveg работают только с ключом Ollama Cloud

NightTrek ставится только сборкой из исходников; run и chat_completion отдают ответ целиком, без потоковой выдачи, таймаут по умолчанию 60 секунд

rawveg распространяется под лицензией AGPL-3.0

Если не работает

ollama_web_search и ollama_web_fetch не работают

Эти инструменты ходят в Ollama Cloud: добавьте OLLAMA_API_KEY в env сервера.

Веб-поиск отвечает ошибкой 429

Это лимит запросов Ollama Cloud: сервер сам повторяет запрос до 3 раз с паузой из заголовка Retry-After. Если ошибка осталась, подождите и повторите.

NightTrek не находит Modelfile по пути вида $HOME/models/Modelfile

Переменные и выражения оболочки в путях не раскрываются: укажите полный путь. Кавычки вокруг пути с пробелами не нужны.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Ollama MCP Server	rawveg (Tim Green)	178	локально	не нужен	13	13 августа 2026
Ollama MCP Server	NightTrek	75	локально	не нужен	10	9 ноября 2026

Частые вопросы

Чем отличаются два сервера?

rawveg ставится из npm, работает и с локальной Ollama, и с Ollama Cloud, считает эмбеддинги и ищет в интернете. NightTrek собирается из исходников, умеет запускать сервер Ollama и отдаёт чат в формате OpenAI.

Как подключить Ollama на другом компьютере?

Укажите его адрес в переменной OLLAMA_HOST. По умолчанию оба сервера обращаются к http://127.0.0.1:11434.

Можно использовать облачные модели Ollama?

Да, в rawveg задайте OLLAMA_HOST=https://ollama.com и OLLAMA_API_KEY. Если оставить локальный адрес и добавить ключ, локальные модели будут работать вместе с веб-поиском и загрузкой страниц.

Как получить эмбеддинги через Ollama MCP?

В rawveg есть ollama_embed: агент передаёт модель, например nomic-embed-text, и список строк, а сервер возвращает векторы.

Как подключить Ollama MCP к Claude Code?

Откройте вкладку Claude Code в блоке «Как подключить»: сервер rawveg запускается командой npx -y ollama-mcp, адрес Ollama задаётся в OLLAMA_HOST.

Где скачать Ollama MCP?

Сервер rawveg лежит в npm как пакет ollama-mcp: npx скачает его сам, а npm install -g ollama-mcp поставит глобально. Исходники — в репозитории rawveg/ollama-mcp на GitHub.

Работает ли сервер из России?

Сервер и модели Ollama работают на вашем компьютере, ключи не нужны; облачные модели и веб-поиск требуют аккаунта на ollama.com.

Ollama MCP: сервер для локальных моделей в Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы