OpenRouter MCP Multimodal
Один MCP-сервер даст агенту чат с сотнями моделей OpenRouter, анализ изображений, аудио и видео и генерацию медиа
- 103 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Платные вызовы тратят баланс вашего ключа OpenRouter, а запросы и файлы уходят внешним моделям
- Инструменты читают и пишут локальные файлы внутри разрешенных каталогов
Установка
- Работает в
Ручная установка
npx -y @stabgan/openrouter-mcp-multimodalПеременная `OPENROUTER_API_KEY` обязательна; Node.js 22 или новее.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Платные вызовы тратят баланс вашего ключа OpenRouter, а запросы и файлы уходят внешним моделям
- Инструменты читают и пишут локальные файлы внутри разрешенных каталогов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к OpenRouter и открывает 21 инструмент в семи группах. Чат работает через `chat_completion` с выбором модели, суффиксами `:free` и `:online`, веб-поиском, структурированным ответом по JSON Schema и асинхронными задачами. Зрение и аудио покрывают `analyze_image`, `generate_image`, `analyze_audio`, распознавание и синтез речи. Для видео есть `analyze_video` и генерация из текста или картинки с уведомлениями о прогрессе. Отдельные инструменты дают эмбеддинги (`embed_text`), реранжирование документов, поиск и проверку моделей по каталогу OpenRouter и инструмент `decide` для решений вида да или нет с оценкой вероятности. Для файлов заданы песочницы входных и выходных путей и защита от SSRF.
Для кого. Разработчикам, которым из Cursor или Claude нужны разные модели и мультимодальные задачи через один ключ OpenRouter.
Подходит, если
- Агент должен сравнить ответы нескольких моделей на одном промпте через `chat_completion`
- Из репозитория надо вытащить текст со скриншота или описать картинку с помощью `analyze_image`
- Запись созвона требует расшифровки, а в проекте уже есть ключ OpenRouter
- Нужен ролик из текста или кадра, и ожидание генерации идет с уведомлениями о прогрессе
- Для поиска по документам нужны эмбеддинги и реранжирование без отдельного сервиса
Не подходит, если
- Нужен только один провайдер напрямую: прямой SDK проще и без посредника
- Нет ключа OpenRouter и нет желания его заводить: сервер без ключа не работает
- Данные нельзя отправлять внешним моделям: запросы уходят в OpenRouter и дальше провайдерам
Пример запроса к агенту
Опиши, что изображено на screenshots/error.png, а затем спроси у двух разных моделей, как исправить эту ошибку, и сравни ответыMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
OPENROUTER_API_KEYобязательная, секрет- Ключ OpenRouter с openrouter.ai/keys.
Ограничения
Нужен ключ `OPENROUTER_API_KEY` и Node.js 22 или новее. Бесплатные модели вроде `google/gemma-4-26b-a4b-it:free` покрывают чат и анализ изображений, а генерация видео и аудио обычно требует кредитов на балансе. Платные вызовы тратят деньги пользователя, лимиты выставляет OpenRouter. Из России оплата и доступ к OpenRouter зависят от условий самого сервиса, статус проверяйте до установки. Версия через `uvx` только запускает Node-пакет, Node.js все равно нужен.
Как отключить. Удалите запись `openrouter` из `mcpServers` в конфигурации клиента и отзовите ключ на openrouter.ai/keys.
Частые вопросы
Как подключить OpenRouter MCP Multimodal к Cursor?
Задайте `OPENROUTER_API_KEY` и добавьте в `.cursor/mcp.json` запись `openrouter` с командой `npx` и аргументами `-y @stabgan/openrouter-mcp-multimodal`. Есть и кнопка быстрой установки.
Можно ли начать без оплаты?
Да, бесплатные модели с суффиксом `:free` работают для чата и анализа изображений. Генерация аудио и видео обычно требует кредитов.
Какие способы установки есть?
`npx`, глобальный `npm`, Docker Hub и GHCR, Smithery и `uvx`: последний запускает Node-пакет через тонкую Python-обертку.
Какая лицензия?
Apache-2.0.
Как выбрать модель?
Через параметр модели в `chat_completion`; `search_models` и `validate_model` помогают найти и проверить имя по каталогу OpenRouter.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, через который Claude Code, Codex и другие агенты зовут Gemini, GPT, Grok и локальные модели для ревью, отладки и консенсуса
Официальный MCP-сервер OrcaRouter: каталог моделей с ценами и чат с автороутингом и цепочкой запасных моделей.
Настольное приложение с локальным MCP-сервером: ChatGPT получает файлы, команды, скиллы и другие MCP-серверы
MCP-сервер, который вставляет в задачи агента шаг обратной связи: веб или десктоп-окно для текста, картинок и промптов
MCP-сервер evaluate отдает агенту вероятности и выбор из вариантов, например срочность обращения, чтобы код ветвился по числу
MCP-сервер общей комнаты для агентов: решения, задачи с проверкой другим агентом и итоговый отчет, вход по коду.
Коротко о README
Сводная таблица возможностей по группам, быстрый старт с ключом, способы установки и конфигурации для Cursor, VS Code, Claude Desktop и Windsurf, затем безопасность, поиск неполадок и разработка.