mcp-proxy
Прокси между транспортами MCP: подключает stdio-клиентов к удаленным SSE и HTTP серверам и публикует локальные серверы по сети
- 2 808 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Открывает сетевой порт к локальному серверу
- Передает токены доступа к удаленным серверам
Установка
- Работает в
Ручная установка
uv tool install mcp-proxyАльтернатива: pipx install mcp-proxy.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Открывает сетевой порт к локальному серверу
- Передает токены доступа к удаленным серверам
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-proxy работает в двух режимах. В первом он запускается клиентом вроде Claude Desktop через stdio и пересылает запросы на удаленный сервер по SSE или Streamable HTTP, в том числе с заголовками авторизации и OAuth2. Во втором он поднимает HTTP-порт и запускает за ним локальный stdio-сервер, так что к нему можно подключиться удаленно. За одним прокси можно держать несколько именованных серверов, описав их флагами или JSON-файлом. Поставляется как пакет PyPI и контейнерный образ.
Для кого. Для разработчиков и администраторов, которые связывают MCP-клиенты и серверы с несовместимыми транспортами.
Подходит, если
- Клиент поддерживает только stdio, а сервер доступен лишь по SSE или HTTP
- Нужно запустить локальный stdio-сервер на машине и обращаться к нему по сети
- Нужно поднять несколько серверов за одним портом в Docker
Не подходит, если
- Клиент уже умеет подключаться к удаленным серверам напрямую
- Нужны группировка, фильтрация инструментов и веб-интерфейс: для этого есть шлюзы вроде MetaMCP
Пример запроса к агенту
Подключи удаленный MCP-сервер по SSE к Claude Desktop через mcp-proxyMCP
- Транспорт
- stdio, sse, http
- Авторизация
- не нужна
Переменные окружения
API_ACCESS_TOKENсекрет- Bearer-токен для подключения к удаленному серверу
Ограничения
Сам прокси не добавляет инструментов, он только переводит транспорт. По умолчанию слушает 127.0.0.1, при открытии на 0.0.0.0 защиту доступа нужно настраивать отдельно. Флаги --sse-port и --sse-host устарели.
Как отключить. Удалите блок mcp-proxy из конфигурации клиента и выполните uv tool uninstall mcp-proxy.
Частые вопросы
Claude Desktop пишет ENOENT при запуске
Укажите в поле command полный путь к mcp-proxy, его покажет which mcp-proxy.
Можно ли держать несколько серверов?
Да, через --named-server или --named-server-config, каждый будет доступен по пути /servers/имя/.
Чем mcp-proxy отличается от прямого подключения к удаленному MCP?
Прокси работает в двух режимах: запускается клиентом вроде Claude Desktop через stdio и пересылает запросы на удаленный сервер по SSE или Streamable HTTP, в том числе с заголовками авторизации. Во втором режиме публикует локальные серверы по сети.
Как установить mcp-proxy и исправить ENOENT в Claude Desktop?
Установка: uv tool install mcp-proxy. Ошибка ENOENT обычно значит, что Claude Desktop не нашел команду. Укажите в конфиге полный путь к mcp-proxy, который покажет which mcp-proxy. Работает с Claude Desktop, Claude Code и Cursor.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыСамостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
CLI-плагин docker mcp и шлюз: MCP-серверы из каталога Docker в изолированных контейнерах через одну точку подключения
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
SSH MCP Server (classfang) — команды на сервере по SSH
SSH MCP Server (classfang)
MCP-сервер для SSH: агент выполняет команды, читает и пишет файлы по SFTP, передает файлы и запускает долгие задачи, а пароли остаются у вас
SSH MCP
ssh-mcp
SSH-сервер с упором на безопасность: классификация команд, авторизация по политикам и разные способы входа. Выполняет команды на удаленных серверах
MCP Gateway
mcp-gateway
Обратный прокси и управление жизненным циклом серверов MCP на Kubernetes и Azure от Microsoft: маршрутизация, авторизация, роли. Для команд платформы
Коротко о README
README разбирает оба режима со схемами, таблицами аргументов и примерами запуска. Описаны именованные серверы и формат JSON-файла для них. Приведены установка через uv, pipx, из репозитория и в контейнере, расширение образа своим Dockerfile и пример Docker Compose. В конце полный список аргументов командной строки. Лицензия MIT.