pctx CLI
pctx превращает инструменты и MCP-серверы в код, который агент запускает в песочнице, не прогоняя каждый результат через контекст.
- 286 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Код, написанный моделью, выполняется в песочнице с разрешенными сетевыми узлами.
- Подключенные MCP-серверы действуют под вашей авторизацией.
Установка
- Работает в
Ручная установка
brew install portofcontext/tap/pctxДругие варианты: скрипт cURL и `npm i -g @portofcontext/pctx`. Затем `pctx code-mode init`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Код, написанный моделью, выполняется в песочнице с разрешенными сетевыми узлами.
- Подключенные MCP-серверы действуют под вашей авторизацией.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pctx — открытый слой выполнения для вызовов инструментов в режиме Code Mode. Вместо того чтобы вызывать инструменты по одному и возвращать тысячу строк в контекст, агент пишет код на TypeScript, и он исполняется в изолированной песочнице Deno. В сеть этот код ходит только по узлам из конфигурации. Есть два режима. Единый MCP-сервер собирает подключенные MCP-серверы за одним интерфейсом и держит сессии между вызовами `execute_typescript`: `pctx code-mode init`, `pctx code-mode add` и `pctx code-mode dev` или `start --stdio`. Сервер сессий `pctx code-mode serve` работает с Python SDK `pctx-client` для агентов на OpenAI Agents SDK и аналогах.
Для кого. Разработчикам агентов, у которых MCP-серверы возвращают большие ответы и забивают контекст, а токены уходят на пересылку промежуточных данных.
Подходит, если
- Таблица на тысячу строк проходит через контекст, хотя агенту нужны пятьдесят.
- Несколько MCP-серверов подключены к агенту, и их нужно держать за единым входом.
- Авторизация к MCP-серверам должна сохраняться между вызовами.
- Код, написанный моделью, должен работать с ограниченным списком сетевых адресов.
Не подходит, если
- Задача состоит из одного простого вызова инструмента: прослойка только добавит сложностей.
- Нужна поддержка Node SDK: в README он помечен как готовящийся.
- Среда запрещает запуск Deno и исполнение сгенерированного кода.
Пример запроса к агенту
Подключи MCP Stripe и память через pctx, запусти его как stdio-сервер и выбери из таблицы платежей только возвраты за неделю.Ограничения
Агент исполняет сгенерированный код, поэтому ограничения песочницы и список разрешенных сетевых узлов нужно задавать явно. Python SDK работает как HTTP-клиент сервера `pctx`, Node SDK пока обещан. Для автоматической установки в README предложен скрипт `curl | sh`, прочтите его до запуска. Подключенные MCP-серверы вроде Stripe выполняют реальные операции под вашей авторизацией, их права нужно ограничить. Последний коммит репозитория датирован ноябрем 2026 года.
Как отключить. Удалите запись `pctx` из MCP-конфигурации клиента и пакет, которым ставили: `brew uninstall pctx` или `npm uninstall -g @portofcontext/pctx`. Конфигурацию `pctx.json` удалите вручную.
Частые вопросы
Что такое Code Mode?
Агент пишет код, который исполняется в песочнице и сам фильтрует данные. Результат возвращается в контекст уже сжатым.
Как подключить MCP-сервер?
Командой `pctx code-mode add`, например `pctx code-mode add stripe https://mcp.stripe.com` или `--command` для stdio-серверов.
Как поставить?
Через Homebrew `brew install portofcontext/tap/pctx`, скриптом cURL или `npm i -g @portofcontext/pctx`.
Что ограничивает песочница?
Код идет в изолированном Deno и может обращаться только к сетевым узлам из файла конфигурации.
Для чего Python SDK?
Он подключает режим Code Mode к агентам на Python с собственными инструментами и MCP-серверами. Это HTTP-клиент к серверу `pctx`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыДает агенту вызывать инструменты MCP и UTCP через выполнение кода: поиск инструментов, готовый код и запуск цепочек вместо десятков отдельных вызовов
Мост для MCP: один инструмент run_python запускает код в контейнере и вызывает ваши MCP-серверы
Универсальный CLI-клиент MCP от Apify: постоянные сессии, OAuth, JSON-вывод для скриптов и доступ агента к любому MCP-серверу через оболочку
MCP-сервер, который держит крупный вывод инструментов вне контекстного окна агента и хранит память сессии в SQLite
CLI, который на лету превращает любой MCP-сервер, спецификацию OpenAPI или GraphQL-эндпоинт в набор команд без генерации кода
CLI для любого MCP-сервера: список и вызов инструментов, ресурсов и промптов, mock и proxy режимы, guard-фильтр и управление конфигами агентов
Коротко о README
В README описаны установка, два режима работы, Python SDK, единый MCP, объяснение Code Mode на примере и свойства песочницы. Лицензия MIT.