jmunch-mcp — MCP-сервер для Claude Code: сжимает ответы инструментов
Прозрачный прокси перед другими MCP-серверами: превращает громоздкие ответы инструментов в запрашиваемые хендлы и экономит токены.
claude mcp add jmunch-mcp -- uvx jmunch-mcpЧто делает jmunch-mcp
jmunch-mcp ставится между вашим агентом и любым другим MCP-сервером. Он пропускает через себя каждый вызов, а большие ответы не отдаёт целиком: превращает их в хендлы, к которым агент обращается короткими командами — peek, slice, search, aggregate, describe, list_handles. Табличные данные уходят в SQLite, JSON — в дерево с JSONPath. На замерах с GitHub-сервером и Firecrawl экономия вышла в 88.3% и 98.9% токенов соответственно.
Начать проще всего с jmunch-mcp init: команда сканирует конфиги MCP-клиентов, запущенные процессы и небольшой каталог популярных серверов, показывает чек-лист и пишет по одному <name>.toml в ./configs/ на каждый выбранный upstream. Дальше клиент запускает jmunch-mcp --config <path> вместо самого сервера. Есть и режим шлюза для приложений на OpenAI или Anthropic HTTP API: pip install 'jmunch-mcp[gateway]', затем jmunch-mcp gateway --config configs/gateway.example.toml — и base_url приложения указывает на http://127.0.0.1:7879. Отдельно поднимается дашборд на http://127.0.0.1:7878.
Лицензия MIT — можно менять, распространять и встраивать в коммерческие продукты. А вот лицензии самих upstream-серверов, которые вы проксируете, остаются их собственными: перед распространением проверьте условия каждого. Метрики в дашборде появятся только после того, как прокси запишет первые вызовы, так что сначала прогоните клиент через обёрнутый сервер.
Какие задачи решает
- уложить ответы GitHub MCP в контекст без обрезки
- искать по большому JSON-ответу скрапера, не загружая его целиком
- считать агрегаты по табличному ответу инструмента
- подключить сжатие токенов к приложению на OpenAI API без правок кода
- посмотреть, сколько токенов уходит на каждый upstream
Примеры запросов агенту
- Оберни GitHub MCP через jmunch-mcp и покажи, сколько токенов сэкономилось
- Сделай
peekпо последнему хендлу от Firecrawl - Запусти
jmunch-mcp initи оберни filesystem и fetch
Как установить jmunch-mcp
Командой платформы
claude mcp add jmunch-mcp -- uvx jmunch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from jmunch-mcp <команда>
Командой платформы
codex mcp add jmunch-mcp -- uvx jmunch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from jmunch-mcp <команда>
Файл настроек
{
"mcpServers": {
"jmunch-mcp": {
"command": "uvx",
"args": [
"jmunch-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from jmunch-mcp <команда>
Файл настроек
{
"servers": {
"jmunch-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"jmunch-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from jmunch-mcp <команда>
Командой платформы
gemini mcp add jmunch-mcp uvx jmunch-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from jmunch-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о jmunch-mcp
Как установить jmunch-mcp в Claude Code?
Добавьте сервер командой claude mcp add jmunch-mcp -- uvx jmunch-mcp.
Что делает jmunch-mcp?
Это прокси перед другим MCP-сервером: он пропускает вызовы дальше, а крупные ответы заменяет хендлами, которые агент читает командами peek, slice, search, aggregate, describe и list_handles.
Чем режим gateway отличается от обычного прокси?
Прокси экономит токены MCP-клиентам, а gateway — любому приложению на OpenAI или Anthropic HTTP API, без изменений в коде: достаточно направить base_url на jmunch.
