Ollama MCP Bridge CLI
Прокси перед API Ollama подключает инструменты нескольких MCP-серверов, и клиент получает их без единой правки в коде.
- 107 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Мост запускает подключенные MCP-серверы и выполняет их вызовы от имени модели, а по умолчанию открыт для любых источников CORS.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/ollama-mcp-bridgeОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Мост запускает подключенные MCP-серверы и выполняет их вызовы от имени модели, а по умолчанию открыт для любых источников CORS.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ollama MCP Bridge — сервер на FastAPI, который стоит между клиентом и Ollama. При старте он читает JSON-конфигурацию, подключает все перечисленные MCP-серверы и собирает их инструменты в один список. Запрос к `/api/chat` уходит в Ollama вместе с этим списком, а вызовы инструментов мост выполняет сам и возвращает результаты модели, пока она не закончит ответ. Остальные конечные точки Ollama мост проксирует без изменений, поэтому готовые клиенты работают как раньше. Серверы подключаются по stdio, StreamableHTTP или SSE, а инструменты каждого сервера можно включать и исключать фильтром. Мост умеет стримить ответы, ограничивать число раундов вызовов и работать с облачными моделями Ollama.
Для кого. Разработчикам локальных ИИ-приложений на Ollama, которые хотят дать модели инструменты MCP, не переписывая клиент.
Подходит, если
- Чат-клиент уже говорит с Ollama, и ему нужен доступ к файлам и поиску через MCP-серверы.
- Несколько MCP-серверов должны работать за одним адресом, а лишние инструменты надо отфильтровать.
- Локальная модель вызывает инструменты в цикле, и число раундов нужно ограничить.
- Мост поднимают в Docker рядом с Ollama и открывают клиентам по порту 8000.
Не подходит, если
- Инструменты нужны вне `/api/chat`: только этот маршрут умеет вызывать MCP.
- Агент уже умеет работать с MCP напрямую, и посредник лишний.
- Нужен сервис с авторизацией клиентов: по умолчанию разрешены все источники CORS.
Пример запроса к агенту
Запусти мост к локальному Ollama с конфигурацией из `mcp-config.json` и покажи, какие инструменты он собрал.Ограничения
Требуется Python 3.10 или новее либо Docker, а также работающий Ollama. Инструменты MCP подключаются только к маршруту `/api/chat`, остальные запросы проходят насквозь. По умолчанию мост слушает адрес 0.0.0.0 и пускает любые источники CORS, поэтому за пределами локальной машины его закрывают сетевыми правилами. Лимит раундов вызовов по умолчанию не задан, и зациклившаяся модель будет вызывать инструменты без остановки, пока не задан `--max-tool-rounds`.
Как отключить. Остановите процесс моста или контейнер и верните клиентам прямой адрес Ollama. Пакет из PyPI удаляется командой `pip uninstall ollama-mcp-bridge`.
Частые вопросы
Как запустить мост?
Выполните `uvx ollama-mcp-bridge` либо `pip install --upgrade ollama-mcp-bridge` и затем запустите команду `ollama-mcp-bridge`. Файл конфигурации по умолчанию называется `mcp-config.json`.
Какие MCP-серверы можно подключить?
Локальные процессы по stdio, удаленные адреса по StreamableHTTP и серверы по SSE. Для каждого сервера можно включить фильтр инструментов в режиме include или exclude.
Чем занимается маршрут `/api/chat`?
Он передает запрос в Ollama со всеми инструментами, исполняет вызовы через нужные MCP-серверы и повторяет цикл, пока модель не закончит. Остальные маршруты проксируются без изменений.
Как указать другой адрес Ollama?
Параметр `--ollama-url` задает адрес сервера, по умолчанию это `http://localhost:11434`. Заголовки вроде ключа API добавляются через `--upstream-header`.
Как запустить мост в Docker?
Выполните `docker compose up`: файл `docker-compose.yml` собирает мост, подключается к Ollama на хосте по адресу `host.docker.internal:11434` и открывает порт `8000`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный мост на TypeScript: локальная модель в Ollama вызывает инструменты сразу нескольких MCP-серверов (файлы, почта, поиск) по тексту запроса
Терминальный MCP-клиент для локальных моделей Ollama: инструменты, промпты и ресурсы MCP, режим агента и переключение моделей
Прокси от Open WebUI, который публикует любой MCP-сервер как HTTP API со схемой OpenAPI
Скилл и MCP-сервер Ollaya: агент задает локальным моделям решений типизированные вопросы и получает вероятности без вызова LLM
Прокси сжимает описания инструментов большого MCP-сервера, и модель тратит контекст только на нужные вызовы.
Мост между Claude.ai и вашим OpenClaw: чат делегирует задачи своему ассистенту по OAuth 2.1 через HTTPS
Коротко о README
В репозитории есть мост на FastAPI, документация, Dockerfile и docker-compose с демонстрационным сервером погоды. Конфигурация поддерживает подстановку переменных `${env:VAR_NAME}` и `${workspaceFolder}`. Версия пакета проверяется при старте.