mcp-server-wayback 0.1.0__tar.gz

mcp_server_wayback-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lakshya Mehta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_server_wayback-0.1.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: mcp-server-wayback
+Version: 0.1.0
+Summary: MCP server giving Claude and other LLM clients structured access to the Internet Archive's Wayback Machine.
+Author-email: Lakshya Mehta <lakshyamehta03@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/lakshyamehta03/wayback-machine-mcp
+Project-URL: Repository, https://github.com/lakshyamehta03/wayback-machine-mcp
+Project-URL: Issues, https://github.com/lakshyamehta03/wayback-machine-mcp/issues
+Keywords: mcp,model-context-protocol,internet-archive,wayback-machine,archive,claude,anthropic,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: beautifulsoup4>=4.12
+Dynamic: license-file
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/lakshyamehta03/wayback-machine-mcp/main/Wayback_Machine_logo_2010.svg" alt="Wayback Machine" width="420" />
+
+# wayback-mcp
+
+**A Model Context Protocol server giving Claude structured access to the Internet Archive's Wayback Machine.**
+
+[![CI](https://github.com/lakshyamehta03/wayback-machine-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/lakshyamehta03/wayback-machine-mcp/actions/workflows/test.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![MCP](https://img.shields.io/badge/MCP-1.0+-8A2BE2.svg)](https://modelcontextprotocol.io/)
+[![Built with uv](https://img.shields.io/badge/built%20with-uv-DE5FE9.svg)](https://github.com/astral-sh/uv)
+
+</div>
+
+---
+
+## Overview
+
+`wayback-mcp` is an async Python MCP server that exposes the Internet Archive's six core APIs — Availability, CDX, Advanced Search, Metadata, and Wayback content — as first-class tools, prompts, and resources for Claude. It handles rate limiting, retry/back-off, and response shape normalisation so the model only sees structured Pydantic data.
+
+## Features
+
+- **Six MCP tools** covering availability checks, snapshot lookups, full-text item search, domain crawls, page-text extraction, and item metadata
+- **Four guided prompts** — `research_topic`, `track_site_changes`, `audit_link_rot`, `setup_authentication`
+- **One MCP resource** — `wayback://item/{identifier}` exposes IA item metadata as JSON
+- **Async token-bucket rate limiter** with per-endpoint buckets and `Retry-After` honoring
+- **In-memory response cache** with per-endpoint TTLs to keep token usage and IA load low
+- **Internet Archive S3 authentication** (optional) for higher rate-limit ceilings
+- **Structured error model** — expected failures return `ToolError`; unexpected ones raise
+- **Tested against live IA APIs** via an opt-in `--integration` pytest flag
+
+## Installation
+
+Requires Python 3.11+.
+
+```bash
+pip install mcp-server-wayback
+```
+
+> _Once published to PyPI._ Until then, see [Development](#development) for the from-source workflow.
+
+## Usage
+
+### Wire it into Claude Desktop
+
+Add an entry to `claude_desktop_config.json` (on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "wayback": {
+      "command": "mcp-server-wayback"
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The `wayback` tools, prompts, and resources will appear in the MCP picker.
+
+If you prefer not to install globally, run it on demand with [`uvx`](https://github.com/astral-sh/uv):
+
+```json
+{
+  "mcpServers": {
+    "wayback": {
+      "command": "uvx",
+      "args": ["mcp-server-wayback"]
+    }
+  }
+}
+```
+
+### Optional: Internet Archive authentication
+
+Set both keys in the server's environment to authenticate every IA request and raise your rate-limit ceiling. Run the `setup_authentication` prompt from Claude to walk through it interactively.
+
+```json
+"env": {
+  "WAYBACK_MCP_IA_ACCESS_KEY": "<your access key>",
+  "WAYBACK_MCP_IA_SECRET_KEY": "<your secret key>"
+}
+```
+
+Get keys at <https://archive.org/account/s3.php>.
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `check_availability` | Is this URL archived? Returns the closest snapshot |
+| `lookup_snapshots` | List CDX snapshots for a URL with date / status filters |
+| `search_archive` | Lucene search across IA collections with mediatype + year range |
+| `search_domain` | Discover archived URLs under a domain or path prefix |
+| `get_snapshot_content` | Fetch an archived page and extract its readable text |
+| `get_item_metadata` | Rich structured metadata for any IA item identifier |
+
+## Prompts
+
+| Prompt | What it does |
+|---|---|
+| `research_topic` | Multi-mediatype IA search → synthesised topic overview |
+| `track_site_changes` | Sample snapshots over time → narrate how a page evolved |
+| `audit_link_rot` | Bulk-check URLs and surface archived alternatives |
+| `setup_authentication` | Walks the user through configuring IA S3 keys |
+
+## Development
+
+Requires Python 3.11+ and [`uv`](https://github.com/astral-sh/uv).
+
+```bash
+git clone https://github.com/lakshyamehta03/wayback-machine-mcp.git
+cd wayback-machine-mcp
+uv sync
+uv run mcp-server-wayback      # run the server
+uv run pytest                  # unit tests (httpx mocked via respx)
+uv run pytest --integration    # also hit live Internet Archive APIs
+```
+
+CI runs the unit suite on every push and pull request via GitHub Actions.
+
+## License
+
+[MIT](LICENSE). The Wayback Machine logo is © Internet Archive and used here under fair use to identify the upstream service this project integrates with.
+
+## Acknowledgments
+
+- The [Internet Archive](https://archive.org/) for the Wayback Machine and the open APIs that make this server possible
+- [Anthropic](https://www.anthropic.com/) for the [Model Context Protocol](https://modelcontextprotocol.io/) specification and SDK

mcp_server_wayback-0.1.0/README.md

@@ -0,0 +1,129 @@
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/lakshyamehta03/wayback-machine-mcp/main/Wayback_Machine_logo_2010.svg" alt="Wayback Machine" width="420" />
+
+# wayback-mcp
+
+**A Model Context Protocol server giving Claude structured access to the Internet Archive's Wayback Machine.**
+
+[![CI](https://github.com/lakshyamehta03/wayback-machine-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/lakshyamehta03/wayback-machine-mcp/actions/workflows/test.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![MCP](https://img.shields.io/badge/MCP-1.0+-8A2BE2.svg)](https://modelcontextprotocol.io/)
+[![Built with uv](https://img.shields.io/badge/built%20with-uv-DE5FE9.svg)](https://github.com/astral-sh/uv)
+
+</div>
+
+---
+
+## Overview
+
+`wayback-mcp` is an async Python MCP server that exposes the Internet Archive's six core APIs — Availability, CDX, Advanced Search, Metadata, and Wayback content — as first-class tools, prompts, and resources for Claude. It handles rate limiting, retry/back-off, and response shape normalisation so the model only sees structured Pydantic data.
+
+## Features
+
+- **Six MCP tools** covering availability checks, snapshot lookups, full-text item search, domain crawls, page-text extraction, and item metadata
+- **Four guided prompts** — `research_topic`, `track_site_changes`, `audit_link_rot`, `setup_authentication`
+- **One MCP resource** — `wayback://item/{identifier}` exposes IA item metadata as JSON
+- **Async token-bucket rate limiter** with per-endpoint buckets and `Retry-After` honoring
+- **In-memory response cache** with per-endpoint TTLs to keep token usage and IA load low
+- **Internet Archive S3 authentication** (optional) for higher rate-limit ceilings
+- **Structured error model** — expected failures return `ToolError`; unexpected ones raise
+- **Tested against live IA APIs** via an opt-in `--integration` pytest flag
+
+## Installation
+
+Requires Python 3.11+.
+
+```bash
+pip install mcp-server-wayback
+```
+
+> _Once published to PyPI._ Until then, see [Development](#development) for the from-source workflow.
+
+## Usage
+
+### Wire it into Claude Desktop
+
+Add an entry to `claude_desktop_config.json` (on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "wayback": {
+      "command": "mcp-server-wayback"
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The `wayback` tools, prompts, and resources will appear in the MCP picker.
+
+If you prefer not to install globally, run it on demand with [`uvx`](https://github.com/astral-sh/uv):
+
+```json
+{
+  "mcpServers": {
+    "wayback": {
+      "command": "uvx",
+      "args": ["mcp-server-wayback"]
+    }
+  }
+}
+```
+
+### Optional: Internet Archive authentication
+
+Set both keys in the server's environment to authenticate every IA request and raise your rate-limit ceiling. Run the `setup_authentication` prompt from Claude to walk through it interactively.
+
+```json
+"env": {
+  "WAYBACK_MCP_IA_ACCESS_KEY": "<your access key>",
+  "WAYBACK_MCP_IA_SECRET_KEY": "<your secret key>"
+}
+```
+
+Get keys at <https://archive.org/account/s3.php>.
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `check_availability` | Is this URL archived? Returns the closest snapshot |
+| `lookup_snapshots` | List CDX snapshots for a URL with date / status filters |
+| `search_archive` | Lucene search across IA collections with mediatype + year range |
+| `search_domain` | Discover archived URLs under a domain or path prefix |
+| `get_snapshot_content` | Fetch an archived page and extract its readable text |
+| `get_item_metadata` | Rich structured metadata for any IA item identifier |
+
+## Prompts
+
+| Prompt | What it does |
+|---|---|
+| `research_topic` | Multi-mediatype IA search → synthesised topic overview |
+| `track_site_changes` | Sample snapshots over time → narrate how a page evolved |
+| `audit_link_rot` | Bulk-check URLs and surface archived alternatives |
+| `setup_authentication` | Walks the user through configuring IA S3 keys |
+
+## Development
+
+Requires Python 3.11+ and [`uv`](https://github.com/astral-sh/uv).
+
+```bash
+git clone https://github.com/lakshyamehta03/wayback-machine-mcp.git
+cd wayback-machine-mcp
+uv sync
+uv run mcp-server-wayback      # run the server
+uv run pytest                  # unit tests (httpx mocked via respx)
+uv run pytest --integration    # also hit live Internet Archive APIs
+```
+
+CI runs the unit suite on every push and pull request via GitHub Actions.
+
+## License
+
+[MIT](LICENSE). The Wayback Machine logo is © Internet Archive and used here under fair use to identify the upstream service this project integrates with.
+
+## Acknowledgments
+
+- The [Internet Archive](https://archive.org/) for the Wayback Machine and the open APIs that make this server possible
+- [Anthropic](https://www.anthropic.com/) for the [Model Context Protocol](https://modelcontextprotocol.io/) specification and SDK

mcp_server_wayback-0.1.0/mcp_server_wayback.egg-info/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: mcp-server-wayback
+Version: 0.1.0
+Summary: MCP server giving Claude and other LLM clients structured access to the Internet Archive's Wayback Machine.
+Author-email: Lakshya Mehta <lakshyamehta03@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/lakshyamehta03/wayback-machine-mcp
+Project-URL: Repository, https://github.com/lakshyamehta03/wayback-machine-mcp
+Project-URL: Issues, https://github.com/lakshyamehta03/wayback-machine-mcp/issues
+Keywords: mcp,model-context-protocol,internet-archive,wayback-machine,archive,claude,anthropic,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: beautifulsoup4>=4.12
+Dynamic: license-file
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/lakshyamehta03/wayback-machine-mcp/main/Wayback_Machine_logo_2010.svg" alt="Wayback Machine" width="420" />
+
+# wayback-mcp
+
+**A Model Context Protocol server giving Claude structured access to the Internet Archive's Wayback Machine.**
+
+[![CI](https://github.com/lakshyamehta03/wayback-machine-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/lakshyamehta03/wayback-machine-mcp/actions/workflows/test.yml)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![MCP](https://img.shields.io/badge/MCP-1.0+-8A2BE2.svg)](https://modelcontextprotocol.io/)
+[![Built with uv](https://img.shields.io/badge/built%20with-uv-DE5FE9.svg)](https://github.com/astral-sh/uv)
+
+</div>
+
+---
+
+## Overview
+
+`wayback-mcp` is an async Python MCP server that exposes the Internet Archive's six core APIs — Availability, CDX, Advanced Search, Metadata, and Wayback content — as first-class tools, prompts, and resources for Claude. It handles rate limiting, retry/back-off, and response shape normalisation so the model only sees structured Pydantic data.
+
+## Features
+
+- **Six MCP tools** covering availability checks, snapshot lookups, full-text item search, domain crawls, page-text extraction, and item metadata
+- **Four guided prompts** — `research_topic`, `track_site_changes`, `audit_link_rot`, `setup_authentication`
+- **One MCP resource** — `wayback://item/{identifier}` exposes IA item metadata as JSON
+- **Async token-bucket rate limiter** with per-endpoint buckets and `Retry-After` honoring
+- **In-memory response cache** with per-endpoint TTLs to keep token usage and IA load low
+- **Internet Archive S3 authentication** (optional) for higher rate-limit ceilings
+- **Structured error model** — expected failures return `ToolError`; unexpected ones raise
+- **Tested against live IA APIs** via an opt-in `--integration` pytest flag
+
+## Installation
+
+Requires Python 3.11+.
+
+```bash
+pip install mcp-server-wayback
+```
+
+> _Once published to PyPI._ Until then, see [Development](#development) for the from-source workflow.
+
+## Usage
+
+### Wire it into Claude Desktop
+
+Add an entry to `claude_desktop_config.json` (on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "wayback": {
+      "command": "mcp-server-wayback"
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The `wayback` tools, prompts, and resources will appear in the MCP picker.
+
+If you prefer not to install globally, run it on demand with [`uvx`](https://github.com/astral-sh/uv):
+
+```json
+{
+  "mcpServers": {
+    "wayback": {
+      "command": "uvx",
+      "args": ["mcp-server-wayback"]
+    }
+  }
+}
+```
+
+### Optional: Internet Archive authentication
+
+Set both keys in the server's environment to authenticate every IA request and raise your rate-limit ceiling. Run the `setup_authentication` prompt from Claude to walk through it interactively.
+
+```json
+"env": {
+  "WAYBACK_MCP_IA_ACCESS_KEY": "<your access key>",
+  "WAYBACK_MCP_IA_SECRET_KEY": "<your secret key>"
+}
+```
+
+Get keys at <https://archive.org/account/s3.php>.
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `check_availability` | Is this URL archived? Returns the closest snapshot |
+| `lookup_snapshots` | List CDX snapshots for a URL with date / status filters |
+| `search_archive` | Lucene search across IA collections with mediatype + year range |
+| `search_domain` | Discover archived URLs under a domain or path prefix |
+| `get_snapshot_content` | Fetch an archived page and extract its readable text |
+| `get_item_metadata` | Rich structured metadata for any IA item identifier |
+
+## Prompts
+
+| Prompt | What it does |
+|---|---|
+| `research_topic` | Multi-mediatype IA search → synthesised topic overview |
+| `track_site_changes` | Sample snapshots over time → narrate how a page evolved |
+| `audit_link_rot` | Bulk-check URLs and surface archived alternatives |
+| `setup_authentication` | Walks the user through configuring IA S3 keys |
+
+## Development
+
+Requires Python 3.11+ and [`uv`](https://github.com/astral-sh/uv).
+
+```bash
+git clone https://github.com/lakshyamehta03/wayback-machine-mcp.git
+cd wayback-machine-mcp
+uv sync
+uv run mcp-server-wayback      # run the server
+uv run pytest                  # unit tests (httpx mocked via respx)
+uv run pytest --integration    # also hit live Internet Archive APIs
+```
+
+CI runs the unit suite on every push and pull request via GitHub Actions.
+
+## License
+
+[MIT](LICENSE). The Wayback Machine logo is © Internet Archive and used here under fair use to identify the upstream service this project integrates with.
+
+## Acknowledgments
+
+- The [Internet Archive](https://archive.org/) for the Wayback Machine and the open APIs that make this server possible
+- [Anthropic](https://www.anthropic.com/) for the [Model Context Protocol](https://modelcontextprotocol.io/) specification and SDK

mcp_server_wayback-0.1.0/mcp_server_wayback.egg-info/SOURCES.txt

@@ -0,0 +1,34 @@
+LICENSE
+README.md
+pyproject.toml
+mcp_server_wayback.egg-info/PKG-INFO
+mcp_server_wayback.egg-info/SOURCES.txt
+mcp_server_wayback.egg-info/dependency_links.txt
+mcp_server_wayback.egg-info/entry_points.txt
+mcp_server_wayback.egg-info/requires.txt
+mcp_server_wayback.egg-info/top_level.txt
+src/__init__.py
+src/config.py
+src/models.py
+src/server.py
+src/client/__init__.py
+src/client/cache.py
+src/client/cdx.py
+src/client/extractor.py
+src/client/http.py
+src/client/parsers.py
+src/client/rate_limiter.py
+src/tools/__init__.py
+src/tools/content.py
+src/tools/search.py
+src/tools/snapshots.py
+tests/test_auth.py
+tests/test_cache.py
+tests/test_client.py
+tests/test_content.py
+tests/test_e2e_stdio.py
+tests/test_extractor.py
+tests/test_prompts.py
+tests/test_resources.py
+tests/test_search.py
+tests/test_snapshots.py

mcp_server_wayback-0.1.0/mcp_server_wayback.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mcp_server_wayback-0.1.0/mcp_server_wayback.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcp-server-wayback = wayback_mcp.server:main

mcp_server_wayback-0.1.0/mcp_server_wayback.egg-info/requires.txt

@@ -0,0 +1,4 @@
+mcp>=1.0
+httpx>=0.27
+pydantic>=2.0
+beautifulsoup4>=4.12

mcp_server_wayback-0.1.0/mcp_server_wayback.egg-info/top_level.txt

@@ -0,0 +1 @@
+wayback_mcp

mcp_server_wayback-0.1.0/pyproject.toml

@@ -0,0 +1,73 @@
+[project]
+name = "mcp-server-wayback"
+version = "0.1.0"
+description = "MCP server giving Claude and other LLM clients structured access to the Internet Archive's Wayback Machine."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Lakshya Mehta", email = "lakshyamehta03@gmail.com" },
+]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "internet-archive",
+    "wayback-machine",
+    "archive",
+    "claude",
+    "anthropic",
+    "llm",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "mcp>=1.0",
+    "httpx>=0.27",
+    "pydantic>=2.0",
+    "beautifulsoup4>=4.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/lakshyamehta03/wayback-machine-mcp"
+Repository = "https://github.com/lakshyamehta03/wayback-machine-mcp"
+Issues = "https://github.com/lakshyamehta03/wayback-machine-mcp/issues"
+
+[project.scripts]
+mcp-server-wayback = "wayback_mcp.server:main"
+
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["wayback_mcp", "wayback_mcp.client", "wayback_mcp.tools"]
+
+[tool.setuptools.package-dir]
+"wayback_mcp" = "src"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+markers = [
+    "integration: marks tests as integration (deselected by default)",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "respx>=0.20",
+    "build>=1.2",
+    "twine>=5.0",
+]

mcp_server_wayback-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mcp_server_wayback-0.1.0/src/client/cache.py

@@ -0,0 +1,58 @@
+import asyncio
+import time
+from collections import OrderedDict
+from typing import Callable
+
+import httpx
+
+CacheKey = tuple[str, frozenset]
+
+
+def _make_key(url: str, params: dict | None) -> CacheKey:
+    return (url, frozenset(params.items()) if params else frozenset())
+
+
+class ResponseCache:
+    def __init__(
+        self,
+        max_size: int,
+        ttls: dict[str, float],
+        now: Callable[[], float] = time.monotonic,
+    ) -> None:
+        self._max_size = max_size
+        self._ttls = ttls
+        self._now = now
+        self._entries: "OrderedDict[CacheKey, tuple[float, int, dict, bytes]]" = OrderedDict()
+        self._lock = asyncio.Lock()
+
+    def clear(self) -> None:
+        self._entries.clear()
+
+    async def get(self, url: str, params: dict | None) -> httpx.Response | None:
+        key = _make_key(url, params)
+        async with self._lock:
+            entry = self._entries.get(key)
+            if entry is None:
+                return None
+            expires_at, status, headers, body = entry
+            if self._now() >= expires_at:
+                del self._entries[key]
+                return None
+            self._entries.move_to_end(key)
+        return httpx.Response(status, headers=headers, content=body)
+
+    async def set(
+        self, url: str, params: dict | None, bucket: str, response: httpx.Response
+    ) -> None:
+        ttl = self._ttls.get(bucket)
+        if ttl is None:
+            return
+        key = _make_key(url, params)
+        expires_at = self._now() + ttl
+        headers = dict(response.headers)
+        body = response.content
+        async with self._lock:
+            self._entries[key] = (expires_at, response.status_code, headers, body)
+            self._entries.move_to_end(key)
+            while len(self._entries) > self._max_size:
+                self._entries.popitem(last=False)