gcf-proxy — MCP-сервер для Claude Code: сжатие ответов инструментов
Прокси между MCP-клиентом и сервером: перекодирует ответы инструментов в GCF и экономит токены. Ставится одной строкой в конфиг.
claude mcp add gcf-proxy -- npx -y @blackwell-systems/gcf-proxyЧто делает gcf-proxy
gcf-proxy встаёт между вашим MCP-клиентом и любым MCP-сервером. Ответы инструментов в JSON он перекодирует в GCF, а GCF в аргументах вызовов декодирует обратно в JSON. Ни сервер, ни клиент менять не нужно.
Запускается двумя способами. Локально через stdio: в конфиге MCP пишете gcf-proxy как команду, а сервер передаёте аргументами. Для удалённого сервера указываете --upstream с адресом Streamable HTTP. Флаг --http :9090 превращает прокси в HTTP-сервис, у него есть проверка на /health.
Флаги --session, --cache и --delta включают дедупликацию символов, кэш одинаковых вызовов и отправку только изменившихся данных. По умолчанию ответы короче 100 байт не трогаются. Если работаете с open-weight моделью, есть --no-flatten — она лучше понимает развёрнутую форму вложенных объектов.
Какие задачи решает
- урезать объём JSON, который MCP-сервер отдаёт в контекст
- подключить сжатие к чужому серверу, к которому нет доступа в коде
- проксировать удалённый MCP-сервер по HTTP
- следить за экономией токенов по логам в stderr
- сгладить вложенные объекты для моделей, которые плохо читают плоскую форму
Примеры запросов агенту
- Оберни MCP-сервер памяти через gcf-proxy и покажи статистику экономии
- Запусти
gcf-proxy --verbose uvx yfinance-mcpи скажи, сколько токенов сэкономилось - Подключи gcf-proxy к удалённому серверу через
--upstream http://host:3000/mcp
Как установить gcf-proxy
Командой платформы
claude mcp add gcf-proxy -- npx -y @blackwell-systems/gcf-proxyКомандой платформы
codex mcp add gcf-proxy -- npx -y @blackwell-systems/gcf-proxyФайл настроек
{
"mcpServers": {
"gcf-proxy": {
"command": "npx",
"args": [
"-y",
"@blackwell-systems/gcf-proxy"
]
}
}
}Файл настроек
{
"servers": {
"gcf-proxy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@blackwell-systems/gcf-proxy"
]
}
}
}Командой платформы
gemini mcp add gcf-proxy npx -y @blackwell-systems/gcf-proxyПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gcf-proxy
Как установить gcf-proxy в Claude Code?
Одной командой: claude mcp add gcf-proxy -- npx -y @blackwell-systems/gcf-proxy.
Что делает gcf-proxy?
Перекодирует ответы MCP-инструментов из JSON в GCF и обратно декодирует GCF в аргументах вызовов. Клиент и сервер при этом не меняются.
Нужно ли править код MCP-сервера?
Нет. Прокси запускает сервер как подпроцесс и работает через stdin/stdout. Если сервер ваш, авторы советуют взять библиотеки GCF напрямую — там больше контроля над дедупликацией и дельта-кодированием.
