MCP 서버 및 CLI 도구는 Internet Archive의 Wayback Machine과 상호 작용합니다. 전체 CDX 검색, 스냅 샷 콘텐츠 검색, 스크린 샷 목록, 스냅 샷 비교 및 더 높은 SPN2 속도 제한을위한 옵션 인증.

Stack: TypeScript · Node.js 22+ · ES 모듈 · pnpm · 터보 · Zod

시작하기

Node.js 22+와 pnpm를 요구합니다.

옵션 자격 증명 (거주 액세스 작품, 하지만 인증된 요청은 더 높은 SPN2 비율 제한을 얻을):

archive.org/account/s3.php에 credentials를 얻으십시오.

구조, 시험 및 lint

단일 테스트 파일을 실행하려면:

End-to-end 테스트는 라이브 Wayback Machine API를 입력하고 opt-in입니다.

pnpm validate은 발매 전에 통과해야하는 게이트입니다. prepublishOnly는 자동으로 실행됩니다.

건축

src/bin.ts 항목 포인트입니다. CLI로 호출되거나 MCP 서버와 경로로로드되는지 여부를 감지합니다.

각 도구 모듈은 schema (ListToolsRequestSchema]에 의해 대체) 및 실행 기능 ([T4]]에 의해 대체)을 수출합니다. 새로운 도구는 server.ts에서 두 등록이 필요합니다.

캐싱 TTLs는 의도적이다 — 그들을 정상화하지 않는다:

| 리소스 | TTL | 이유슨 | |—|||||

MCP Wayback Machine Server

MCP server and CLI tool for interacting with the Internet Archive’s Wayback Machine. Supports full CDX search, snapshot content retrieval, screenshot listing, snapshot comparison, and optional authentication for higher SPN2 rate limits.

Stack: TypeScript · Node.js 22+ · ES Modules · pnpm · Turbo · Zod

Getting started

Requires Node.js 22+ and pnpm.

pnpm install

Optional credentials (anonymous access works, but authenticated requests get higher SPN2 rate limits):

export WAYBACK_ACCESS_KEY="your-access-key"
export WAYBACK_SECRET_KEY="your-secret-key"

Obtain credentials at archive.org/account/s3.php.

Build, test, and lint

pnpm validate          # typecheck + lint + build + test + untested-files check (the full CI gate)
pnpm check             # typecheck + lint + build only
pnpm build             # compile TypeScript to dist/
pnpm test              # run unit and integration tests
pnpm test:coverage     # run tests with coverage (80% line/branch/function threshold)
pnpm lint              # lint with ESLint
pnpm lint:fix          # auto-fix lint issues

To run a single test file:

node --test tests/tools/save.unit.test.ts

End-to-end tests hit the live Wayback Machine API and are opt-in:

pnpm test:e2e          # sets WAYBACK_LIVE_TESTS=1 internally via turbo

pnpm validate is the gate that must pass before a release. prepublishOnly runs it automatically.

Architecture

src/bin.ts is the entry point. It detects whether it is invoked as a CLI or loaded as an MCP server and routes accordingly.

src/
  bin.ts          — entry point; dispatches to CLI or MCP server
  cli.ts          — Commander-based CLI implementation
  server.ts       — MCP server wiring (ListTools + CallTool handlers)
  contexts.ts     — shared context (rate limiter, cache, credentials)
  schemas.ts      — Zod schemas for all tool inputs; single source of truth
  tools/