EvidenceLens MCP

EvidenceLens MCP ist ein TypeScript-Model-Context-Protocol-Server für deterministische, schreibgeschützte Evidenz-Review-Verträge. Das einzelne review_evidence-Tool akzeptiert Inline-Inhalte der Phase 2 und, wenn explizit konfiguriert, Dateisystemquellen der Phase 3. Es normalisiert Text, Tabellen, PDFs, Bilder und Screenshots zu Provenienz-Metadaten, während die Befunde leer bleiben und keine Provider-Aufrufe erfolgen.

Lokale Entwicklung

npm install
npm run dev
npm test
npm run build

npm run dev startet den MCP-Server über stdio aus src/server.ts. npm test führt die vollständige Testsuite für Vertrag, Normalisierer, Sicherheit und MCP-Protokoll aus. npm run build führt die Typprüfung durch und kompiliert den Server.

Related MCP server: smart-read-mcp

MCP-Vertrag

Siehe docs/mcp-contract.md für den genauen Inline-/Dateisystem-Anfragevertrag, die Grammatik der Root-Konfiguration, Byte-Grenzen, filesystem://-Provenienz, normalisierte Evidenz-Metadaten, stabile Fehler und die Grenzen für read-only/keine Provider/keine Befunde.

Plattformhinweis: Der Standard-Dateisystemleser verwendet auf Linux descriptor-relative Komponenten-Navigation. Auf macOS, wo dieses Projekt keine unterstützte Node-openat/openat2-Bindung hat, schlagen standardmäßig verankerte Dateisystemlesevorgänge mit bereinigtem ACCESS_DENIED und ohne Bytes fehl; es gibt keinen Pfadnamen-Fallback. Inline-Evidenz der Phase 2 bleibt unterstützt, und Einbettungstests können einen geprüften sicheren Dateisystemadapter für eine portable Dateisystem-Leseabdeckung injizieren.

Optionale Dateisystem-Roots

Der Dateisystemzugriff ist deaktiviert, wenn keine Roots konfiguriert sind; der Server fällt nie auf das aktuelle Verzeichnis, das Home-Verzeichnis, das Repository oder einen anderen breiten Standard zurück. Konfigurieren Sie explizite Roots mit wiederholten id=absolute-path-Einträgen, getrennt durch Kommas oder Semikolons:

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

Root-IDs entsprechen [A-Za-z][A-Za-z0-9_-]{0,31}. Leere Einträge, doppelte IDs, kanonische Pfadkollisionen, nicht lesbare Roots, Nicht-Verzeichnisse, relative Pfade und fehlerhafte Einträge schlagen mit der stabilen Meldung Invalid filesystem root configuration fehl; Pfade werden nie wiedergegeben.