cap-shield MCP server

Выбор контекста и сжатие для ИИ-агентов — с измеренной, а не заявленной полнотой.

Сам сервер не импортирует ничего, кроме стандартной библиотеки. Установите его как пакет или возьмите как один файл — оба варианта работают.

Почему

Больше контекста делает агентов хуже. ETH Zurich обнаружил, что файлы контекста СНИЖАЮТ успешность выполнения задач по сравнению с отсутствием контекста репозитория у агента, при этом повышая стоимость инференса более чем на 20 %. Около двух третей сбоев продакшн-агентов связаны с проблемами контекста, а не с неспособностью модели.

Итак, вопрос не в том, сколько вы сокращаете. Вопрос в том, достаточно ли того, что вы сохранили, — и это измеряется здесь, на бенчмарке, который мы не выбирали: LongMemEval-S, 500 вопросов. Recall@10 составляет 93,8 % против лексического базового уровня 51,9 %.

Recall@10 — это строгая мера: вопрос засчитывается только тогда, когда найдены ВСЕ эталонные сессии. Нахождение половины ответа означает, что агент уверенно отвечает на основе половины.

Два из пяти инструментов не требуют аккаунта. Сначала измерьте, потом решайте.

Related MCP server: compresh-mcp

Установка

pip install cap-shield

{
  "mcpServers": {
    "cap-shield": {
      "command": "cap-shield-mcp",
      "env": {
        "CAP_SHIELD_API_KEY": "cap_live_..."
      }
    }
  }
}

Python 3.9+. Блок env нужен только для remember и assemble_context — если его опустить, два измерительных инструмента всё равно работают.

Также опубликован в официальном реестре MCP как io.github.robinlidberg-dot/cap-shield.

Предпочитаете один файл вместо пакета?

curl -O https://cap-shield-robin.fly.dev/cap_mcp.py

Тогда команда — python, а аргумент — путь к файлу.

Необязательный SKILL.md сообщает агенту, когда использовать эти инструменты — а когда нет.

Инструменты

measure_traffic · без аккаунта

Измерьте, сколько трафика вашего агента можно сэкономить. НЕ НУЖЕН АККАУНТ ИЛИ КЛЮЧ — используйте это первым. Возвращает экономию байтов в сети и, если задан запрос, экономию токенов от выборочного извлечения контекста. Ничего не сохраняется: текст сжимается в памяти и отбрасывается. Ограничение: 20 вызовов в час на IP.

list_packages · без аккаунта

Перечислите доступные словари с их ИЗМЕРЕННЫМ сжатием, включая те, которые работают плохо. Каждая запись указывает, работает ли она с одним сообщением за раз или только пакетно, и сколько сообщений получились БОЛЬШЕ. Ключ не нужен.

remember · требуется ключ

Сохраните запись памяти для последующего извлечения. ТРЕБУЕТСЯ КЛЮЧ. Это не вызывает языковую модель — он сохраняет текст в изолированном архиве для каждого арендатора. Используйте assemble_context, чтобы получить релевантные записи обратно.

assemble_context · требуется ключ

Извлеките записи памяти, которые отвечают на вопрос, в рамках бюджета токенов. ТРЕБУЕТСЯ КЛЮЧ. Отправьте возвращённый 'context' вашей языковой модели ВМЕСТО всей истории. Это не вызывает модель саму по себе — он выбирает, что отправить. Бюджет — это потолок, а не цель: выбор останавливается там, где заканчивается релевантность, часто значительно ниже. В ответе указано, сколько записей было оставлено и почему.

get_account

Получите аккаунт и API-ключ. Требуется адрес электронной почты. Ключ возвращается ОДИН РАЗ и не может быть показан снова — сохраните его немедленно. Бета-квоты намеренно низкие; это жёсткие ограничения, а не выставление счетов за превышение.

Приведённые выше описания скопированы дословно с сервера. Если они когда-либо отличаются от того, что возвращает tools/list, сервер прав, а этот файл устарел.

Что означают цифры

Сжатие экономит байты в сети. Выбор экономит токены в контексте. Это два разных механизма — их сложение даёт число, которое ничего не значит.

Сжатые пакеты распаковываются до того, как модель их увидит, поэтому это не снижает стоимость инференса. Утверждать обратное — самый простой способ ошибиться в этом проекте.

Каждая цифра публикуется вживую, включая то, что не было измерено, и какие пакеты работают плохо:

https://cap-shield-robin.fly.dev/.well-known/cap-shield.json

Получите это, а не доверяйте этому файлу. Он устаревает; документ — нет.

Измерение без MCP

pip install cap-shield

from cap_shield import measure, print_measurement
print_measurement(measure(texts=[...], query="..."))

Без аккаунта, ничего не сохраняется. Ответ включает долю ухудшенных сообщений — сколько ваших сообщений получились больше.

Пакетная обработка имеет условие безопасности

Пакетная обработка сжимает несколько сообщений в одном контексте, что открывает побочный канал в стиле CRIME/BREACH: тот, кто может поместить выбранный текст в один пакет с секретом и наблюдать за размером пакета, узнаёт что-то о секрете.

Пакетируйте только те сообщения, которые уже находятся в одной доверительной границе. Необязательное дополнение закрывает утечку менее чем за два байта на сообщение, и оно выключено по умолчанию — мы говорим об этом, а не позволяем вам предполагать иное.

Индивидуальная упаковка не имеет этой проблемы вообще.

Переносимость

Версии словарей никогда не удаляются, и гарантия не зависит от того, что мы всё ещё здесь: экспорт архива содержит бинарные файлы словарей, а автономный распаковщик работает без шлюза, без сети и без какой-либо другой части системы.

https://cap-shield-robin.fly.dev/cap_unpack.py

Он предоставляется без токена, потому что больше всего он нужен тому, у кого больше нет аккаунта.

Статус

Бета. Версия сервера 0.1.0.

Документация: https://cap-shield-robin.fly.dev/docs/quickstart Консоль: https://cap-shield-console.lovable.app

Лицензия

MIT — см. LICENSE.