MCP-LLM Bridge CLI
Терминальный мост на TypeScript: локальная модель в Ollama вызывает инструменты сразу нескольких MCP-серверов (файлы, почта, поиск) по тексту запроса
- 984 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Сам выбирает и выполняет инструменты подключенных MCP-серверов по тексту запроса, без отдельного подтверждения перед вызовом
- В примере настройки подключен сервер Gmail и Google Drive с доступом к почте и файлам аккаунта после разовой авторизации
- Файловый MCP-сервер может читать и писать файлы в разрешенной директории по выбору локальной модели
Установка
Ручная установка
git clone https://github.com/patruff/ollama-mcp-bridge && cd ollama-mcp-bridge && npm install && npm run startПеред запуском поставьте модель в Ollama (например ollama pull qwen2.5-coder:7b-instruct) и нужные MCP-серверы, затем впишите их в bridge_config.json.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сам выбирает и выполняет инструменты подключенных MCP-серверов по тексту запроса, без отдельного подтверждения перед вызовом
- В примере настройки подключен сервер Gmail и Google Drive с доступом к почте и файлам аккаунта после разовой авторизации
- Файловый MCP-сервер может читать и писать файлы в разрешенной директории по выбору локальной модели
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-LLM Bridge запускается командой `npm run start` и открывает интерактивный терминал, в котором локальная модель Ollama отвечает на запросы пользователя и сама решает, какой подключенный MCP-сервер вызвать. Мост регистрирует инструменты каждого сервера из `bridge_config.json` (файловая система, поиск Brave, GitHub, Gmail и Google Drive, память, генерация изображений Flux) и определяет, какой инструмент подходит запросу, по ключевым словам и контексту фразы: операции с почтой находит по адресам `email`, операции с Google Drive по словам про файлы и папки, поисковые запросы направляет в подходящий поисковый инструмент. После выбора инструмента мост получает от модели структурированный вызов, проверяет его и передает нужному MCP-серверу по протоколу JSON-RPC, а ответ сервера возвращает модели для финального текстового ответа пользователю. В примере из README мост настроен на модель Qwen 2.5 7B через Ollama и обращается к серверам `@modelcontextprotocol/server-filesystem`, `@modelcontextprotocol/server-brave-search`, `@modelcontextprotocol/server-github`, `@modelcontextprotocol/server-memory` и собственным серверам автора `@patruff/server-flux` и `@patruff/server-gmail-drive`, но набор серверов и модель можно сменить, изменив `bridge_config.json`.
Для кого. Для тех, кто хочет дать локальной модели в Ollama доступ к тем же инструментам MCP, что есть у Claude (файлы, поиск, почта, GitHub), без обращения к облачной модели.
Подходит, если
- Нужно подключить локальную модель Ollama сразу к нескольким MCP-серверам без облачного провайдера
- Нужен терминальный помощник, который сам определяет, какой инструмент из подключенных вызвать по тексту запроса
- Есть свои MCP-серверы (как серверы автора для Flux и Gmail/Drive) и нужен готовый мост, который их зарегистрирует
- Нужен пример настройки локальной модели с доступом к файловой системе, поиску и почте в одном конфигурационном файле
Не подходит, если
- Нужен готовый пользовательский интерфейс с подтверждением каждого действия перед выполнением: README не описывает шаг подтверждения, определение инструмента и его вызов идут автоматически
- Нужна актуальная поддержка последних версий MCP-серверов: с апреля 2025 года в репозитории нет новых коммитов, а зависимости вроде @modelcontextprotocol/server-* могли обновить протокол
- Нужна официальная интеграция почты или GitHub: `@patruff/server-gmail-drive` и доступ к GitHub через персональный токен собраны автором отдельно от официальных серверов проекта MCP
- Автор не указал тестовое покрытие маршрутизации инструментов для случаев вне примеров из README (почта, поиск, файлы): для нестандартных формулировок запроса результат проверять вручную
Пример запроса к агенту
Найди в интернете последние новости о TypeScript и сохрани краткую выжимку в файл notes/typescript.mdОграничения
Лицензия MIT.
- С апреля 2025 года в репозитории нет новых коммитов: при звездах около тысячи это не повод отклонять запись, но совместимость с текущими версиями MCP-серверов и Ollama нужно проверять самостоятельно.
- Определение нужного инструмента по тексту запроса работает на ключевых словах и контексте фразы (адреса `email`, слова про файлы и папки), а не на структурированном выборе модели среди описаний инструментов.
- Серверы Gmail и Google Drive из примера требуют отдельной аутентификации командой вида `node путь/к/gmail-drive/index.js auth`, а сервер Flux — ключ `REPLICATE_API_TOKEN`.
- Автор приводит в README путь установки для Windows с абсолютным путем вида C:\Users\<имя>\AppData\Roaming\npm\node_modules\..., на других системах путь будет отличаться.
- Набор серверов, модель и ее параметры задаются в `bridge_config.json`: без правки этого файла мост подключается только к серверам и модели из примера автора.
Как отключить. Остановите процесс командой `quit` внутри терминала моста или обычным завершением процесса, затем удалите установленные MCP-серверы отдельно (`npm uninstall -g @modelcontextprotocol/server-filesystem` и аналогично для остальных) и саму папку репозитория.
Частые вопросы
Нужен ли облачный ключ Anthropic или OpenAI для MCP-LLM Bridge?
Нет, мост рассчитан на локальную модель через Ollama, в примере README это Qwen 2.5 7B. Ключи нужны только для отдельных MCP-серверов: Brave Search, GitHub и Flux через Replicate, а не для самой языковой модели.
Как мост выбирает, какой MCP-сервер вызвать?
По ключевым словам и контексту текста запроса: операции с почтой определяются по адресам электронной почты в тексте, операции с Google Drive по словам о файлах и папках, а поисковые запросы направляются в подходящий поисковый инструмент.
Поддерживает ли проект последние версии MCP-серверов?
В репозитории нет коммитов с апреля 2025 года, поэтому совместимость с текущими версиями пакетов @modelcontextprotocol/server-* стоит проверить перед использованием. Структура кода при этом рассчитана на любой сервер, который реализует протокол MCP.
Можно ли подключить собственный MCP-сервер вместо примеров из README?
Да, набор серверов задается в bridge_config.json как обычная конфигурация MCP с командой запуска и путем к серверу. Пример автора использует собственные серверы `@patruff/server-flux` и `@patruff/server-gmail-drive`, но подойдет любой сервер, который отвечает по протоколу JSON-RPC.
Нужна ли отдельная авторизация для Gmail и Google Drive?
Да, сервер gmail-drive из примера требует отдельный шаг аутентификации командой `node путь/к/gmail-drive/index.js auth` до первого использования. Без этого шага инструменты почты и диска останутся недоступны мосту.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТерминальный MCP-клиент для локальных моделей Ollama: инструменты, промпты и ресурсы MCP, режим агента и переключение моделей
CLI для запуска промптов LLM и работы как MCP-клиент прямо из терминала, с любым MCP-сервером и любым провайдером модели
CLI для любого MCP-сервера: список и вызов инструментов, ресурсов и промптов, mock и proxy режимы, guard-фильтр и управление конфигами агентов
MCP-сервер, через который Claude Code, Codex и другие агенты зовут Gemini, GPT, Grok и локальные модели для ревью, отладки и консенсуса
oterm — терминальный чат с Ollama, OpenAI, Anthropic и другими провайдерами: сессии в SQLite, MCP-серверы, встроенные и собственные инструменты
Универсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку
Коротко о README
Описание репозитория короткое: общий абзац о назначении моста, список поддерживаемых возможностей серверов (файловая система, поиск Brave, GitHub, Google Drive и Gmail, память, генерация изображений Flux) и раздел «Текущая настройка» с конкретной моделью и серверами из примера автора. Дальше идет раздел архитектуры с четырьмя компонентами (мост, клиент языковой модели, клиент MCP, маршрутизатор инструментов) и пошаговая инструкция установки и настройки учетных данных.