EvidenceLens MCP

EvidenceLens MCP 是一个 TypeScript Model Context Protocol 服务器，用于确定性的、只读的证据审查契约。唯一的 review_evidence 工具接受 Phase 2 内联内容，并在显式配置时接受 Phase 3 文件系统来源。它将文本、表格、PDF、图像和截图规范化为来源元数据，同时保持发现为空，并且不进行任何提供商调用。

本地开发

npm install
npm run dev
npm test
npm run build

npm run dev 通过 stdio 从 src/server.ts 启动 MCP 服务器。npm test 运行完整的契约、规范化器、夹具、安全性和 MCP 协议测试套件。npm run build 进行类型检查并编译服务器。

Related MCP server: smart-read-mcp

MCP 契约

参见 docs/mcp-contract.md 了解精确的内联/文件系统请求契约、根配置语法、字节限制、filesystem:// 来源、规范化的证据元数据、稳定的错误，以及只读/无提供商/无发现的边界。

平台说明：默认的文件系统读取器在 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 失败；路径永远不会被回显。