mcp-remote CLI
Адаптер, который подключает MCP-клиент с поддержкой только локальных stdio-серверов к удаленному MCP-серверу по HTTP или SSE, вместе с авторизацией
- 1 668 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Пробрасывает трафик и учетные данные к удаленному серверу, который вы укажете
- Хранит токены OAuth локально и обновляет их
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mcp-remoteОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Пробрасывает трафик и учетные данные к удаленному серверу, который вы укажете
- Хранит токены OAuth локально и обновляет их
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-remote это промежуточный слой между MCP-клиентом, который умеет только локальные stdio-серверы, и удаленным MCP-сервером по HTTP или SSE. Он запускается через npx внутри конфигурации mcpServers и берет на себя поток авторизации OAuth, обновление токенов и их локальное хранение. Поддерживает произвольные заголовки и файл заголовков, изоляцию сессий по ресурсу RFC 8707, дополнительные параметры авторизации, выбор порта и хоста колбэка, таймауты, keep-alive, прокси и фильтрацию инструментов удаленного сервера. Нужен, пока популярные клиенты не научатся сами ходить в удаленные авторизованные серверы.
Для кого. Для пользователей Claude Desktop, Cursor, Windsurf и других клиентов, которым нужно подключиться к удаленному MCP-серверу с авторизацией.
Подходит, если
- Клиент поддерживает только локальные stdio-серверы, а нужен удаленный
- Удаленный сервер требует OAuth или пользовательских заголовков
- Нужно развести несколько аккаунтов одного сервера по отдельным сессиям
Не подходит, если
- Клиент уже подключается к удаленным авторизованным серверам напрямую
- Нужен сам MCP-сервер, а не адаптер к нему
Пример запроса к агенту
Подключи меня к удаленному MCP-серверу по этому URL через mcp-remoteОграничения
Это адаптер, а не сервер: он лишь пробрасывает трафик к удаленному серверу и передает ему ваши учетные данные и заголовки. Токены OAuth хранятся локально в каталоге ~/.mcp-auth. Часть клиентов неверно экранирует пробелы в аргументах, для таких случаев README предлагает обходные варианты через переменные окружения или файл заголовков. Доступность конкретного удаленного сервера зависит от самого сервера.
Как отключить. Удалите запись сервера из блока mcpServers в конфигурации клиента. Кэш авторизации лежит в каталоге ~/.mcp-auth.
Частые вопросы
Это отдельный MCP-сервер?
Нет. Это адаптер, который подключает stdio-клиент к удаленному серверу по HTTP или SSE и ведет за него авторизацию.
Куда попадают токены?
Токены OAuth и данные сессий хранятся локально в каталоге ~/.mcp-auth, отдельно для каждой комбинации URL, ресурса и заголовков.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыУниверсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку
Прокси от Open WebUI, который публикует любой MCP-сервер как HTTP API со схемой OpenAPI
MCP-сервер, который по просьбе агента ставит другие MCP-серверы из npm и PyPI и прописывает их в конфигурацию
CLI для любого MCP-сервера: список и вызов инструментов, ресурсов и промптов, mock и proxy режимы, guard-фильтр и управление конфигами агентов
CLI mcpl ищет инструменты сразу по нескольким MCP-серверам и вызывает их из терминала, а вход по OAuth делает человек
CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода
Из блога
Коротко о README
README объясняет, зачем нужен адаптер: большинство клиентов работают только с локальными stdio-серверами и пока не умеют сами проходить OAuth к удаленным. mcp-remote запускается через npx и закрывает этот разрыв. Документация подробно разбирает флаги: пользовательские заголовки и файл заголовков, параметр --resource для изоляции сессий, дополнительные параметры авторизации, выбор порта и хоста колбэка, таймауты, keep-alive, прокси и фильтрацию инструментов. Отдельно описаны обходные пути для клиентов, которые ломают пробелы в аргументах.