Pi MCP Adapter — плагин
Расширение для агента Pi, которое подключает MCP-серверы через один прокси-инструмент и не забивает контекст описаниями инструментов
- 1 649 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает подключенные MCP-серверы и передает им вызовы инструментов
- Хранит токены OAuth и статические токены в системном хранилище ключей
Установка
Ручная установка
pi install npm:pi-mcp-adapterУстанавливается в агенте Pi, после установки Pi нужно перезапустить.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает подключенные MCP-серверы и передает им вызовы инструментов
- Хранит токены OAuth и статические токены в системном хранилище ключей
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Адаптер решает проблему раздувания контекста при работе с MCP: описания инструментов одного сервера могут занимать больше десяти тысяч токенов, и вы платите за них, даже если инструменты не используете. Вместо этого адаптер дает агенту Pi один прокси-инструмент mcp примерно на двести токенов, через который модель ищет нужный инструмент по запросу и вызывает его, а серверы по умолчанию ленивые и стартуют только при первом обращении. Метаданные инструментов кешируются, поэтому поиск и описание работают без живых подключений. Адаптер читает стандартные файлы конфигурации MCP, умеет импортировать настройки из конфигов Cursor, Claude Code, Codex и других хостов, поддерживает OAuth и статические токены с хранением в системном хранилище ключей, подтверждение вызовов, защиту вывода и режим прямых инструментов для часто используемых серверов.
Для кого. Для пользователей агента Pi, которые подключают несколько MCP-серверов и хотят экономить контекст.
Подходит, если
- В Pi подключено много MCP-серверов и они забивают контекст описаниями инструментов
- Нужно, чтобы серверы стартовали только при реальном обращении
- Нужно перенести в Pi настройки MCP из конфигов Cursor, Claude Code или Codex
- Нужен единый поиск по инструментам всех подключенных серверов
Не подходит, если
- Вы работаете не в агенте Pi, а в другом клиенте
- Подключен один небольшой сервер и экономия контекста не нужна
Пример запроса к агенту
Найди среди подключенных серверов инструмент для скриншотов и сделай снимок страницыОграничения
Адаптер работает внутри агента Pi и ставится его менеджером пакетов, к другим агентам он напрямую не подключается, хотя может импортировать их конфиги MCP как совместимые источники. Часть возможностей требует свежих версий Node: команды работы с токенами нужен Node 22.18 или новее. Постоянное хранение OAuth опирается на системное хранилище ключей, а на headless Linux на разблокированный keyring, иначе адаптер отказывает вместо небезопасного хранения в открытом виде. Импорт поддерживается для ограниченного списка хостов: cursor, claude-code, claude-desktop, opencode, vscode, windsurf, codex.
Как отключить. Удалите расширение pi-mcp-adapter из Pi тем же менеджером пакетов, которым ставили. Отдельный сервер можно выключить командой /mcp disable <server>, она пишет флаг в проектный файл .pi/mcp.json.
Частые вопросы
С какими агентами это работает?
Адаптер предназначен для агента Pi. Настройки MCP из конфигов Cursor, Claude Code, Codex и других хостов он умеет импортировать, но сам запускается внутри Pi.
Как экономится контекст?
Вместо сотен описаний инструментов агент видит один прокси-инструмент mcp, а конкретные инструменты находит поиском по запросу и вызывает по имени.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Плагины1MCP Agent
1mcp-agent
Один сервер MCP вместо многих: агент объединяет подключенные серверы и отдает их клиенту через единый адрес. Версия бета
Расширение для агента Pi сворачивает вызовы инструментов в компактные строки и показывает правки файлов наглядными диффами
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
Официальный плагин со скиллами для сборки MCP Apps: интерактивных UI поверх инструментов MCP, которые открываются прямо в Claude
Прозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
Коротко о README
README объясняет, что адаптер дает агенту Pi доступ к MCP-серверам через один прокси-инструмент вместо сотен описаний, экономя контекст. Серверы по умолчанию ленивые и стартуют при первом вызове, метаданные кешируются для поиска без подключения. Адаптер читает стандартные файлы MCP, описывает порядок приоритета конфигов, импорт настроек из хостов вроде Cursor и Claude Code, загрузку серверов из пакетов Agent Plugins и локальных плагинов Claude. Отдельные разделы посвящены OAuth и хранению токенов, подтверждению вызовов, защите вывода, прямым инструментам и интеграции MCP UI. Установка идет командой pi install npm:pi-mcp-adapter. Лицензия MIT.