mcp-remote
Адаптер, который подключает MCP-клиент с поддержкой только локальных stdio-серверов к удаленному MCP-серверу по HTTP или SSE, вместе с авторизацией
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Пробрасывает трафик и учетные данные к удаленному серверу, который вы укажете
- Хранит токены OAuth локально и обновляет их
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mcp-remoteОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Установите утилиту
npm install -g mcp-remoteДобавь в конфигурацию клиента запись mcpServers с command npx и args mcp-remote и URL удаленного сервера. Для авторизации по токену добавь --header с заголовком Authorization.
Другие способы из описания автора
{
"mcpServers": {
"remote-example": {
"command": "npx",
"args": ["mcp-remote", "https://remote.mcp.server/sse"]
}
}
}Замените URL на адрес нужного удаленного сервера. Для токена добавьте в args --header и Authorization: Bearer <токен>.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
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.
Проверка безопасности
- Пробрасывает трафик и учетные данные к удаленному серверу, который вы укажете
- Хранит токены OAuth локально и обновляет их
Коротко о README
README объясняет, зачем нужен адаптер: большинство клиентов работают только с локальными stdio-серверами и пока не умеют сами проходить OAuth к удаленным. mcp-remote запускается через npx и закрывает этот разрыв. Документация подробно разбирает флаги: пользовательские заголовки и файл заголовков, параметр --resource для изоляции сессий, дополнительные параметры авторизации, выбор порта и хоста колбэка, таймауты, keep-alive, прокси и фильтрацию инструментов. Отдельно описаны обходные пути для клиентов, которые ломают пробелы в аргументах.
Частые вопросы
Это отдельный MCP-сервер?
Нет. Это адаптер, который подключает stdio-клиент к удаленному серверу по HTTP или SSE и ведет за него авторизацию.
Куда попадают токены?
Токены OAuth и данные сессий хранятся локально в каталоге ~/.mcp-auth, отдельно для каждой комбинации URL, ресурса и заголовков.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Открытая библиотека промптов с плагином Claude Code, MCP-сервером и CLI: поиск, получение и улучшение промптов и скиллов из агента