MCP サーバーとCLI ツールは、インターネット アーカイブのWayback Machineとやり取りします。 完全なCDX検索をサポート, スナップショットコンテンツ検索, スクリーンショットリスト, スナップショット比較, より高いSPN2レート制限のためのオプション認証.

スタック: TypeScript・Node.js 22+・ESモジュール・pnpm・ターボ・ゾド

はじめる

Node.js 22 と pnpm が必要です。

オプションの資格情報(匿名アクセスが機能しますが、認証されたリクエストは、より高いSPN2レートの制限を取得します):

archive.org/account/s3.php で認証情報を入手してください。

##ビルド、テスト、およびlint

単一のテストファイルを実行するには:

エンドツーエンドのテストは、ライブウェイバックマシンAPIをヒットし、オプトインします。

[[pnpm validate]は、リリース前に通過しなければならないゲートです。 [[prepublishOnly]は自動的に実行されます。

アーキテクチャ

[src/bin.ts]はエントリーポイントです。 これにより、CLI として呼び出されるか、MCP サーバーとして読み込まれているか、それに応じてルートを検知します。

各ツールモジュールは、スキーマ([ListToolsRequestSchema])と実行関数([CallToolRequestSchemaによって構成される)をエクスポートします。 [server.ts で両方の登録が必要です。

TTL をキャッシュすることは意図的であり、それらを正規化しません。

| リソース | 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/