elentra-local-connector

プライベートでローカルな読み取り専用のMCPコネクタ。資格情報を保存せず、既存の認証済みChromeセッションを利用して、Claude Desktopで自分のuOttawa Elentraデータを検索できるようにします。

仕様: 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

意図的に4つのプロセスで構成されています。Chromeはネイティブメッセージングホストを子プロセスとして生成するため、そのホストと同一のデーモンはChromeと一緒に終了し—無人で行われているICSポーリングが停止し—さらにサービスワーカーの再起動のたびに再生成されることになり、1つのライターしか許可しないWALデータベースに対して2つのライターが発生します。リレーは約100行のステートレスなコードで、これらの両方の問題を解決します。

セットアップ

ビルドは自動化されていますが、接続設定は自動化されていません。docs/HANDOFF.md を参照してください — スクリプト化できないChromeとmacOSの手順が約10分あります。

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 をスローする関数に置き換えるため、ネットワークへアクセスしようとするテストは、黙って成功するのではなく失敗します。

保証

• パスワードを保存することはありません。パスワードコードパスは存在しません。

• ブラウザのクッキーをエクスポートすることはありません。

• ログイン、MFA、SSOの更新を自動化することはありません。期限切れになると停止して通知します。

• モデルに汎用的な request(method, url) ツールを公開することはありません。

• リポジトリにはコードのみが含まれます。フィクスチャは100%合成データです。

不変条件については SECURITY.md を、Anthropicに送信される内容については PRIVACY.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。