EvidenceLens MCP

EvidenceLens MCP es un servidor TypeScript del Model Context Protocol para contratos deterministas de revisión de evidencia de solo lectura. La única herramienta review_evidence acepta contenido en línea de la Fase 2 y, cuando se configura explícitamente, fuentes del sistema de archivos de la Fase 3. Normaliza texto, tablas, PDFs, imágenes y capturas de pantalla en metadatos de procedencia, manteniendo los hallazgos vacíos y sin realizar llamadas a proveedores.

Desarrollo local

npm install
npm run dev
npm test
npm run build

npm run dev inicia el servidor MCP a través de stdio desde src/server.ts. npm test ejecuta la suite de pruebas completa de contrato, normalizador, fixtures, seguridad y protocolo MCP. npm run build comprueba los tipos y compila el servidor.

Related MCP server: smart-read-mcp

Contrato MCP

Consulta docs/mcp-contract.md para conocer el contrato exacto de solicitudes en línea/sistema de archivos, la gramática de configuración de raíces, los límites de bytes, la procedencia filesystem://, los metadatos de evidencia normalizados, los errores estables y los límites de solo lectura/sin proveedor/sin hallazgos.

Nota sobre plataformas: el lector de sistema de archivos predeterminado utiliza recorrido de componentes relativo a descriptores en Linux. En macOS, donde este proyecto no tiene un enlace Node openat/openat2 compatible, las lecturas de sistema de archivos ancladas predeterminadas fallan de forma segura con ACCESS_DENIED saneado y sin bytes; no hay respaldo por nombre de ruta. La evidencia en línea de la Fase 2 sigue siendo compatible, y las pruebas de incrustación pueden inyectar un adaptador de sistema de archivos seguro revisado para una cobertura portátil de lectura del sistema de archivos.

Raíces opcionales del sistema de archivos

El acceso al sistema de archivos está deshabilitado cuando no se configuran raíces; el servidor nunca recurre al directorio actual, al directorio personal, al repositorio ni a otro valor predeterminado amplio. Configura raíces explícitas con entradas repetidas id=absolute-path separadas por comas o puntos y coma:

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

Los ID de raíz coinciden con [A-Za-z][A-Za-z0-9_-]{0,31}. Las entradas vacías, los ID duplicados, las colisiones de rutas canónicas, las raíces ilegibles, los elementos que no son directorios, las rutas relativas y las entradas malformadas fallan con el mensaje estable Invalid filesystem root configuration; las rutas nunca se muestran.