Skip to content

Cyreslab-AI/wayback-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wayback Machine MCP Server

smithery badge

This is a Model Context Protocol (MCP) server that provides access to the Internet Archive's Wayback Machine. It allows you to retrieve archived versions of web pages and check available snapshots of URLs.

Wayback Machine Server MCP server

Features

Tools

  1. get_snapshots

    • Get a list of available snapshots for a URL from the Wayback Machine
    • Parameters:
      • url (required): URL to check for snapshots
      • from (optional): Start date in YYYYMMDD format
      • to (optional): End date in YYYYMMDD format
      • limit (optional): Maximum number of snapshots to return (default: 100)
      • match_type (optional): Type of URL matching to use (default: exact)
        • Options: 'exact', 'prefix', 'host', 'domain'
  2. get_archived_page

    • Retrieve the content of an archived webpage from the Wayback Machine
    • Parameters:
      • url (required): URL of the page to retrieve
      • timestamp (required): Timestamp in YYYYMMDDHHMMSS format
      • original (optional): Whether to get the original content without Wayback Machine banner (default: false)

Resource Templates

  1. wayback://{url}/{timestamp}
    • Access archived web pages from the Internet Archive Wayback Machine
    • Parameters:
      • url: The webpage URL to retrieve
      • timestamp: The specific archive timestamp (YYYYMMDDHHMMSS format)

Installation

Installing via Smithery

To install Wayback Machine Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Cyreslab-AI/wayback-mcp-server --client claude

Manual Installation

  1. Clone this repository
  2. Install dependencies: npm install
  3. Build the project: npm run build
  4. Add the server to your MCP settings file:
{
  "mcpServers": {
    "wayback-machine": {
      "command": "node",
      "args": ["/path/to/wayback-server/build/index.js"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Usage Examples

Get Snapshots

use_mcp_tool(
  server_name="wayback-machine",
  tool_name="get_snapshots",
  arguments={
    "url": "example.com",
    "from": "20200101",
    "to": "20201231",
    "limit": 10
  }
)

Get Archived Page

use_mcp_tool(
  server_name="wayback-machine",
  tool_name="get_archived_page",
  arguments={
    "url": "example.com",
    "timestamp": "20200101120000",
    "original": true
  }
)

Access Resource

access_mcp_resource(
  server_name="wayback-machine",
  uri="wayback://example.com/20200101120000"
)

API Details

This server uses the following Wayback Machine APIs:

  1. Availability API: https://archive.org/wayback/available?url={url}
  2. CDX Server API: https://web.archive.org/cdx/search/cdx?url={url}&output=json
  3. Wayback Machine Memento API: https://web.archive.org/web/{timestamp}/{url}

License

ISC

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •