pi-mcp-adapter — скилл для Claude Code: что делает и как установить
Скилл pi-mcp-adapter для агента Pi подключает MCP-серверы через один прокси-инструмент вместо сотен описаний в контексте. Серверы соединяются по требованию.
лицензия не указана 202 установок ★ 9 обновлён 2026-10-09
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a claude-codeЧто делает pi-mcp-adapter
Скилл ставит в агент Pi адаптер MCP-серверов. Крупный сервер приносит с собой 10k+ токенов описаний инструментов, а адаптер отдаёт один прокси mcp примерно на 200 токенов: через него ищут инструменты, смотрят схему параметров и вызывают нужный. Соединение открывается по требованию, поэтому контекст не пухнет. Внутри Pi адаптер ставится командой pi install npm:pi-mcp-adapter, потом Pi перезапускают.
Настройки читаются из четырёх файлов: ~/.config/mcp/mcp.json, ~/.pi/agent/mcp.json, .mcp.json и .pi/mcp.json, каждый следующий перекрывает предыдущий. Сервер задаётся командой запуска с аргументами и переменными окружения либо URL для HTTP/SSE с заголовками. OAuth тоже есть: при autoAuth: true вход проходит на первом вызове инструмента, без него открывайте оверлей /mcp и жмите Enter или ctrl+a.
directTools выносит схемы инструментов прямо в системный промпт, и каждый стоит 150-300 токенов. Для сервера с сотнями инструментов это возвращает исходную проблему, так что список держите коротким. Остальное прячется через excludeTools, а lifecycle выбирает между lazy, eager и keep-alive. idleTimeout по умолчанию 10 минут, ноль его отключает.
Какие задачи решает
- подключить MCP-сервер к Pi, не раздувая контекст
- настроить ленивую загрузку серверов и таймаут простоя
- вывести в промпт только те инструменты, которые реально вызываются
- пройти OAuth для сервера при первом обращении к инструменту
- сложить общий и проектный конфиги MCP в нужном приоритете
Примеры запросов агенту
- Подключи chrome-devtools MCP к Pi через pi-mcp-adapter и оставь прокси-режим.
- Добавь сервер github в
.mcp.json, токен возьми из переменнойGITHUB_TOKEN. - Включи
directToolsтолько дляsearch_repositoriesиget_file_contents, остальное спрячь.
Как установить pi-mcp-adapter
1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a claude-code2Вручную: положить файлы
~/.claude/skills/pi-mcp-adapter/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pi-mcp-adapter/
1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a codex2Вручную: положить файлы
.agents/skills/pi-mcp-adapter/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a cursor2Вручную: положить файлы
.cursor/skills/pi-mcp-adapter/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/pi-mcp-adapter2Вручную: положить файлы
.github/skills/pi-mcp-adapter/SKILL.md1Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a gemini-cli2Командой платформы
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/pi-mcp-adapterВручную: положить файлы
.devin/skills/pi-mcp-adapter/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о pi-mcp-adapter
Как установить pi-mcp-adapter в Claude Code?
Запустите npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a claude-code. Файл скилла окажется по пути ~/.claude/skills/pi-mcp-adapter/SKILL.md.
Что делает pi-mcp-adapter?
Прячет описания инструментов MCP-серверов за одним прокси-инструментом mcp и открывает соединение только при вызове. Серверы читаются из стандартных файлов конфигурации, включая .mcp.json.
Сколько контекста съедает directTools?
Каждый инструмент, вынесенный напрямую, добавляет примерно 150-300 токенов к системному промпту. Поэтому включать его целиком имеет смысл для небольшого набора приоритетных инструментов, а не для всего сервера.