Frame Check

Узнайте, что скрывает любой документ.

Frame Check — это инструмент для анализа структурного фрейминга. Он определяет, какие перспективы принимает документ, какие опускает и как он позиционирует читателя. Числовые утверждения сверяются с авторитетными источниками, если по ним имеются данные.

Быстрый старт (MCP-сервер)

Пакет PyPI frame-check-mcp является сервером протокола Model Context Protocol (MCP). Он работает локально и предоставляет любому MCP-совместимому ИИ-клиенту (Claude Desktop, Cursor, Cline, Continue.dev и др.) детерминированный анализ структурного фрейминга в качестве инструмента.

pip install frame-check-mcp

Затем укажите вашему MCP-клиенту установленную точку входа. Для Claude Desktop добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "frame-check": {
      "command": "frame-check-mcp"
    }
  }
}

Перезапустите клиент. Затем в любом диалоге: "Can you frame-check this document?" (Можешь выполнить frame-check этого документа?). Полная установка и детали проверки приведены в MCP_SERVER.md.

Related MCP server: Analysis MCP

Что он делает

Вы передаете документ, и Frame Check возвращает:

• Профиль структурного фрейминга: какие из пяти аналитических перспектив (причины, риски, заинтересованные стороны, тенденции, неопределенность) охватывает документ, какие опускает, и плотность каждой из них.

• Голос и эпистемическая позиция: как документ позиционирует читателя и какая доля утверждений приписана источникам.

• Временная ориентация: основывает ли документ свои выводы на исторических данных, текущем состоянии или прогнозах.

• Соответствия стандарту Frame Vocabulary Standard: именованные шаблоны фреймов, чьи основанные на правилах сигналы срабатывают на тексте, каждый с идентификационными признаками и примерами. Соответствия являются кандидатными; точность по сравнению с разметкой из нескольких источников — предмет активных исследований.

• Верификация сети источников: числовые утверждения проверяются по SEC EDGAR, FRED, Всемирному банку, REST Countries, Alpha Vantage и Wolfram Alpha, если эти провайдеры имеют соответствующие данные.

• Дополнительное ИИ-повествование, интерпретирующее фрейминг на уровне текста. Маркируется отдельно, чтобы читатели не путали интерпретацию языковой модели с детерминированным измерением.

Подход

Структурное измерение — это база. Каждое утверждение о фрейминге, которое делает инструмент, вычисляется на основе детерминированных сопоставителей шаблонов и всегда возвращает один и тот же результат для одного и того же ввода. Интерпретация с помощью ИИ доступна в качестве дополнения при настройке API-ключа, но она помечена как таковая и никогда не скрывается за структурным слоем.

Верификация ограничена. Инструмент проверяет числовые утверждения только по провайдерам с реальным охватом для данного типа утверждений и выводит свои собственные результаты калибровки (точность, полнота, F1 для каждого провайдера), а не делает выводы без доказательств.

Детектирование именованных шаблонов — это отдельный уровень надежности, отличный от структурного профиля. F1 детектора = 0.36 по сравнению с экспертной разметкой в предварительно зарегистрированной валидации, что ниже полезного порога в 0.4. Переход к выявлению честности конструкта (маркеры недодетектов, оговорки о плотности, состояния уверенности) вместо уверенных меток является несущим утверждением в версии v0; исследование помощи читателю (Track B, предварительно зарегистрированное) проверяет, помогает ли это выявление читателю увидеть фрейминг, который он иначе бы пропустил.

Честные ограничения и ожидаемые критические прочтения каталогизированы в ANTICIPATED_CRITIQUES.md.

Документация

• METHODOLOGY.md — полный документ по методологии (черновик v0.2)

• MCP_SERVER.md — справочник по MCP-серверу (инструменты, ресурсы, промпты)

• MCP_CLIENT_CONFORMANCE_v1.md — 32/32 прогона соответствия для установленного wheel-пакета

• FRAME_DIVERGENCE_v1.md и FRAME_DIVERGENCE_v2.md — архитектура расхождения фреймов

• data/frame_library/ — каталог FVS из 20 записей с примерами

• ANTICIPATED_CRITIQUES.md — самоперечисленные критические прочтения

• VALIDATION_PROGRAM.md — планы наблюдательной и формальной валидации

Запуск тестов

pip install -r requirements.txt
python3 run_tests.py

49 наборов тестов, ~3 минуты. Включает 63 теста состязательного диспетчера в test_mcp_adversarial.py плюс покрытие движка V4.2 и классификатора.

Лицензия

Apache-2.0 для кода; CC-BY-4.0 для библиотеки FVS и примеров (см. NOTICE для перечисления по директориям).

Цитирование

Если Frame Check полезен в вашей работе, см. CITATION.cff для формы цитирования. Автор Frame Check — Ловро Лучич; именованное авторство является основным активом доверия проекта в соответствии с дисциплиной честности конструкта.

Участие в разработке

Требуется Sign-off-by-DCO согласно CONTRIBUTING.md. Управление согласно GOVERNANCE.md (модель BDFL с именованными принудительными функциями для решений о продвижении канона). Взаимодействие с внешними рецензентами согласно REVIEWERS.md.

Проблемы

https://github.com/lluvr/frame-check-mcp/issues