elentra-local-connector

사용자의 자격 증명을 저장하지 않고 기존의 인증된 Chrome 세션을 빌려서 Claude Desktop이 본인의 uOttawa Elentra 데이터를 검색할 수 있게 해주는 비공개, 로컬, 읽기 전용 MCP 커넥터입니다.

사양: PRD-FINAL.md가 권위 있는 문서입니다. 상태: 읽기 전용입니다. write_enabled = false는 빌드 타임 상수입니다.

여기서 "live"가 의미하는 것

커넥터가 활성화되어 있는 동안 합리적으로 최신 상태를 유지한다는 뜻이며, 푸시 보장은 아닙니다. Elentra는 웹훅, 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 폴링이 중단되고, 서비스 워커가 재시작될 때마다 다시 생성되어 하나만 허용되는 WAL 데이터베이스에 대해 두 개의 작성자가 생기게 됩니다. 릴레이는 상태 비저장 코드 약 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에서 불변 조건을, PRIVACY.md에서 Anthropic에 전달되는 내용을 확인하세요.

라이선스

MIT — LICENSE를 참조하세요.