EvidenceLens MCP

EvidenceLens MCP は、決定的で読み取り専用のエビデンスレビュー契約のための TypeScript Model Context Protocol サーバーです。唯一の review_evidence ツールは、Phase 2 のインラインコンテンツと、明示的に設定された場合の Phase 3 のファイルシステムソースを受け入れます。テキスト、表、PDF、画像、スクリーンショットを来歴メタデータに正規化し、findings を空のままにし、プロバイダー呼び出しを行いません。

ローカル開発

npm install
npm run dev
npm test
npm run build

npm run dev は、src/server.ts から stdio 経由で MCP サーバーを起動します。npm test は、契約、正規化、フィクスチャ、安全性、MCP プロトコルのテストスイート全体を実行します。npm run build はサーバーの型チェックとコンパイルを行います。

Related MCP server: smart-read-mcp

MCP 契約

正確なインライン/ファイルシステムリクエスト契約、ルート設定の文法、バイト制限、filesystem:// の来歴、正規化されたエビデンスメタデータ、安定したエラー、および読み取り専用/プロバイダーなし/findings なしの境界については、docs/mcp-contract.md を参照してください。

プラットフォームに関する注意: デフォルトのファイルシステムリーダーは、Linux ではディスクリプタ相対のコンポーネント走査を使用します。macOS では、このプロジェクトにはサポートされている Node の openat/openat2 バインディングがないため、デフォルトのアンカー付きファイルシステム読み取りは、サニタイズされた ACCESS_DENIED とバイトなしでフェイルクローズします。パス名によるフォールバックはありません。Phase 2 のインラインエビデンスは引き続きサポートされ、埋め込みテストでは、移植可能なファイルシステム読み取りのカバレッジのために、レビュー済みの安全なファイルシステムアダプターを注入できます。

オプションのファイルシステムルート

ルートが設定されていない場合、ファイルシステムアクセスは無効になります。サーバーが現在のディレクトリ、ホームディレクトリ、リポジトリ、またはその他の広範なデフォルトにフォールバックすることはありません。カンマまたはセミコロンで区切った id=absolute-path エントリを繰り返して、明示的なルートを設定します:

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

ルート ID は [A-Za-z][A-Za-z0-9_-]{0,31} に一致します。空のエントリ、重複する ID、正規パスの衝突、読み取り不能なルート、ディレクトリ以外、相対パス、および不正なエントリは、安定したメッセージ Invalid filesystem root configuration で失敗します。パスがエコーされることは決してありません。