Pi MCP Adapter

Установка

Ручная установка

pi install npm:pi-mcp-adapter

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Адаптер решает проблему раздувания контекста при работе с MCP: описания инструментов одного сервера могут занимать больше десяти тысяч токенов, и вы платите за них, даже если инструменты не используете. Вместо этого адаптер дает агенту Pi один прокси-инструмент mcp примерно на двести токенов, через который модель ищет нужный инструмент по запросу и вызывает его, а серверы по умолчанию ленивые и стартуют только при первом обращении. Метаданные инструментов кешируются, поэтому поиск и описание работают без живых подключений. Адаптер читает стандартные файлы конфигурации MCP, умеет импортировать настройки из конфигов Cursor, Claude Code, Codex и других хостов, поддерживает OAuth и статические токены с хранением в системном хранилище ключей, подтверждение вызовов, защиту вывода и режим прямых инструментов для часто используемых серверов.

Для кого. Для пользователей агента Pi, которые подключают несколько MCP-серверов и хотят экономить контекст.

Пример запроса к агенту

Найди среди подключенных серверов инструмент для скриншотов и сделай снимок страницы

Ограничения

Адаптер работает внутри агента 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.

Проверка безопасности

• Запускает подключенные MCP-серверы и передает им вызовы инструментов
• Хранит токены OAuth и статические токены в системном хранилище ключей

Коротко о README

README объясняет, что адаптер дает агенту Pi доступ к MCP-серверам через один прокси-инструмент вместо сотен описаний, экономя контекст. Серверы по умолчанию ленивые и стартуют при первом вызове, метаданные кешируются для поиска без подключения. Адаптер читает стандартные файлы MCP, описывает порядок приоритета конфигов, импорт настроек из хостов вроде Cursor и Claude Code, загрузку серверов из пакетов Agent Plugins и локальных плагинов Claude. Отдельные разделы посвящены OAuth и хранению токенов, подтверждению вызовов, защите вывода, прямым инструментам и интеграции MCP UI. Установка идет командой pi install npm:pi-mcp-adapter. Лицензия MIT.

Похожие