elentra-local-connector

一个私有的、本地的、只读 MCP 连接器，让 Claude Desktop 可以搜索你自己的 uOttawa Elentra 数据——通过借用你现有的已认证 Chrome 会话，而不是存储任何凭据。

规范： PRD-FINAL.md 为权威依据。 状态： 只读。write_enabled = false 是一个编译期常量。

这里“实时”的含义

在连接器处于活动状态时数据基本及时——但绝不保证推送。Elentra 不提供 webhooks、WebSocket 或 SSE，因此本连接器采用轮询。认证令牌持续 60 分钟，因此数据过期是常态；每个工具响应都带有 fetched_at、is_stale 和 staleness_seconds，以便 Claude 说“3 小时前的数据”，而不是暗示实时真相。

架构

Chrome MV3 extension   has the session · owns the allowlist · GET only
        │              no chrome.cookies · no chrome.scripting
        ▼  native messaging
relay                  thin, stateless, ~100 LOC
        │  unix socket (0600)
        ▼
daemon (launchd)       sole DB writer · parsers · ICS poller · audit
        │  direct SQLite read-only (WAL)
        ▼
mcp-server (stdio)     read-only tools → Claude Desktop

刻意设计为四个进程。Chrome 会将原生消息宿主作为子进程生成，因此一个就是该宿主的守护进程会随 Chrome 一起退出——从而中断无人值守的 ICS 轮询——并在每次 service-worker 重启时被重新生成，进而对只允许一个写入者的 WAL 数据库产生两个写入者。中继只增加约 100 行无状态代码，却解决了这两个问题。

设置

构建是自动化的；配置不是。请参阅 docs/HANDOFF.md——大约 10 分钟的 Chrome 和 macOS 步骤，这些步骤无法脚本化。

pnpm install
pnpm bootstrap  # build, keys, index, daemon, health — idempotent, re-runnable

pnpm bootstrap 会完成所有可脚本化的操作，并报告剩余步骤。如果你更愿意自己运行各个步骤：

pnpm verify     # typecheck + lint + test + secret scan — the gate
pnpm build      # four bundles: mcp, daemon, relay, extension
pnpm build:mcpb # the Claude Desktop .mcpb — separate from pnpm build
pnpm health     # live diagnostics, after handoff

pnpm install && pnpm verify 完全离线运行：测试数据是合成的，tests/no-network.setup.ts 用一个抛出错误的函数替换了 fetch，因此任何尝试访问网络的测试都会失败，而不是悄然成功。

保证

• 绝不存储你的密码；不存在任何密码代码路径。

• 绝不导出浏览器 cookie。

• 绝不自动执行登录、MFA 或 SSO 续期——到期后它会停止并告知你。

• 绝不向模型暴露通用的 request(method, url) 工具。

• 仓库仅包含代码；测试数据 100% 为合成数据。

有关不变量，请参阅 SECURITY.md；有关哪些信息会发送给 Anthropic，请参阅 PRIVACY.md。

许可证

MIT — 参见 LICENSE。