EvidenceLens MCP

EvidenceLens MCP — это TypeScript-сервер протокола Model Context Protocol для детерминированных контрактов проверки доказательств только для чтения. Единственный инструмент review_evidence принимает встроенное содержимое Фазы 2 и, если это явно настроено, источники файловой системы Фазы 3. Он нормализует текст, таблицы, PDF, изображения и скриншоты в метаданные происхождения, оставляя результаты пустыми и не выполняя вызовов к провайдерам.

Локальная разработка

npm install
npm run dev
npm test
npm run build

npm run dev запускает MCP-сервер через stdio из src/server.ts. npm test запускает полный набор тестов контракта, нормализатора, фикстур, безопасности и MCP-протокола. npm run build выполняет проверку типов и компиляцию сервера.

Related MCP server: smart-read-mcp

MCP-контракт

См. docs/mcp-contract.md для точного контракта запросов inline/файловой системы, грамматики корневой конфигурации, лимитов байтов, происхождения filesystem://, нормализованных метаданных доказательств, стабильных ошибок и границ «только чтение / без провайдера / без результатов».

Примечание о платформе: стандартный модуль чтения файловой системы использует обход компонентов, зависящих от дескрипторов, в Linux. На macOS, где этот проект не имеет поддерживаемой привязки Node openat/openat2, стандартное привязанное чтение файловой системы завершается с ошибкой ACCESS_DENIED (санитизированной) и без байтов; запасного варианта по имени пути нет. Встроенные доказательства Фазы 2 остаются поддерживаемыми, а тесты встраивания могут внедрять проверенный безопасный адаптер файловой системы для переносимого покрытия чтения файловой системы.

Необязательные корни файловой системы

Доступ к файловой системе отключен, если не настроено ни одного корня; сервер никогда не возвращается к текущему каталогу, домашнему каталогу, репозиторию или другому широкому значению по умолчанию. Настройте явные корни с повторяющимися записями id=absolute-path, разделенными запятыми или точками с запятой:

EVIDENCELENS_ALLOWED_ROOTS='course=/absolute/path/course;examples=/absolute/path/examples' npm run dev

Идентификаторы корней соответствуют [A-Za-z][A-Za-z0-9_-]{0,31}. Пустые записи, дублирующиеся идентификаторы, коллизии канонических путей, нечитаемые корни, не-каталоги, относительные пути и некорректные записи завершаются стабильным сообщением Invalid filesystem root configuration; пути никогда не выводятся.