MCPProxy — MCP-сервер для Claude Code: прокси, карантин и поиск
Прокси перед всеми вашими MCP-серверами: агент видит небольшой набор инструментов поиска, а новые серверы висят в карантине, пока вы их не одобрите.
Открыть на GitHubЧто делает MCPProxy
MCPProxy разворачивается как локальный процесс на macOS, Linux или Windows: ядро — один бинарник, веб-интерфейс встроен в него, отдельный сервис поднимать не нужно. На macOS есть ещё менюбар-приложение для запуска и остановки и просмотра логов. Подключённые серверы он собирает воедино, поэтому лимиты клиентов вроде ограничения Cursor на 40 инструментов и потолка OpenAI в 128 функций перестают упираться в число серверов.
Агент получает не весь каталог инструментов, а набор инструментов самого прокси — retrieve_tools, describe_tool и варианты call_tool_* — и подтягивает схемы по запросу. Сколько контекста это сэкономит, зависит от количества инструментов, режима маршрутизации и клиента. На эталонном наборе из 45 инструментов стартовое меню прокси оказалось больше, чем простой список всех инструментов, потому что у собственных инструментов есть фиксированная цена; экономия начинается только после точки окупаемости.
Новые серверы попадают в карантин, их инструменты недоступны агенту до вашего одобрения. В режиме доверия manual изменения в описании уже одобренного инструмента снова уходят на проверку. Это снижает риск атак через подмену описаний (Tool Poisoning), но гарантии безопасности не даёт. Опционально к карантинным серверам можно прогнать сканеры в Docker — Snyk, Semgrep, Trivy и другие; находки сводятся в SARIF с общей оценкой риска.
Какие задачи решает
- подключить десятки MCP-серверов, не упираясь в лимит инструментов клиента
- проверить инструменты нового сервера до того, как агент их получит
- сократить стартовое меню инструментов в контексте агента
- прогнать сканеры безопасности по карантинному серверу
- просмотреть журнал активности MCP в менюбар-приложении
Примеры запросов агенту
- Покажи через
retrieve_tools, какие инструменты есть у подключённых серверов - Одобри сервер из карантина после проверки его инструментов
- Опиши схему инструмента перед вызовом через
describe_tool
Как установить MCPProxy
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MCPProxy
Как установить MCPProxy в Claude Code?
Скачайте установщик под свою платформу со страницы релизов: DMG для macOS (arm64 или amd64) либо setup.exe для Windows (x64 или ARM64). Установщик Windows кладёт и сервер, и трей-приложение в Program Files, добавляет программу в PATH и создаёт ярлыки в меню «Пуск».
Что делает MCPProxy?
Ставит один локальный эндпоинт перед всеми вашими MCP-серверами, отдаёт агенту инструменты поиска и вызова по запросу и держит новые серверы в карантине до одобрения.
Сколько контекста он экономит?
Фиксированного процента нет. На эталонном наборе из 45 инструментов стартовое меню прокси вышло больше простого списка, и экономия появляется только когда подключённых инструментов становится много — процент имеет смысл называть вместе с их числом.