# pi-mcp-adapter

Скилл pi-mcp-adapter для агента Pi подключает MCP-серверы через один прокси-инструмент вместо сотен описаний в контексте. Серверы соединяются по требованию.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 202 установки · ★ 9 у репозитория
- Автор: reason-machines
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/pi-mcp-adapter/SKILL.md
- Обновлён: 2026-10-09
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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 минут, ноль его отключает.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/pi-mcp-adapter/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/pi-mcp-adapter/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/pi-mcp-adapter/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/pi-mcp-adapter/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/pi-mcp-adapter
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/pi-mcp-adapter/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/pi-mcp-adapter
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/pi-mcp-adapter/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill pi-mcp-adapter -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/pi-mcp-adapter/SKILL.md

## Когда брать
- подключить MCP-сервер к Pi, не раздувая контекст
- настроить ленивую загрузку серверов и таймаут простоя
- вывести в промпт только те инструменты, которые реально вызываются
- пройти OAuth для сервера при первом обращении к инструменту
- сложить общий и проектный конфиги MCP в нужном приоритете

## Примеры запросов агенту
- Подключи chrome-devtools MCP к Pi через pi-mcp-adapter и оставь прокси-режим.
- Добавь сервер github в `.mcp.json`, токен возьми из переменной `GITHUB_TOKEN`.
- Включи `directTools` только для `search_repositories` и `get_file_contents`, остальное спрячь.

## Похожие
- [authsome](https://affpapa.org/nevibecode/skills/authsome.md) — скилл · 3000 установок
- [claude-code-proxy-patterns](https://affpapa.org/nevibecode/skills/claude-code-proxy-patterns.md) — скилл · 106 установок
- [pi-delegate](https://affpapa.org/nevibecode/skills/pi-delegate.md) — скилл · 3900 установок
- [pi-agent](https://affpapa.org/nevibecode/skills/pi-agent.md) — скилл · 1500 установок
- [migrating-pi-to-pydantic-ai](https://affpapa.org/nevibecode/skills/migrating-pi-to-pydantic-ai.md) — скилл · 470 установок
- [opencli-adapter-author](https://affpapa.org/nevibecode/skills/opencli-adapter-author.md) — скилл · 16600 установок

Из того же набора: [reason-machines/mcp-skills](https://affpapa.org/nevibecode/by/reason-machines/mcp-skills.md) — 98 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
