nicholaswilde/changedetection-mcp-rs repository overview

⁠ChangeDetection.io MCP Server (Rust)

A high-performance Rust implementation of a ChangeDetection.io⁠ Model Context Protocol (MCP)⁠ server. This bridge allows AI models (like Claude or other MCP-compatible clients) to monitor website changes, manage watchlists, and retrieve snapshots directly.

⁠✨ Features

This server provides a consolidated toolset optimized for low token usage and efficient context management:

• watch_ops: Full management of website watches (Create, Update, Delete, Trigger, Pause, Mute, etc.).
• tag_ops: Organize and manage watch tags.
• notification_ops: Manage global notification endpoints.
• history_ops: Access watch history, snapshots, diffs, and even screenshots.
• system_ops: Discover system info, fetchers, and global settings.
• maintenance_ops: System-level tasks like backups and exports.

⁠📚 MCP Resources

The server exposes data through the MCP Resources protocol:

• watches://{uuid}/latest: Direct access to the most recent snapshot content.
• system://openapi-spec: Access the ChangeDetection.io OpenAPI specification.

⁠🚀 Quick Start

⁠Run with Docker

You can run the MCP server directly using Docker. Replace the environment variables with your specific instance details.

docker run -d \
  -e CHANGEDETECTION_API_KEY="your_api_key" \
  -e CHANGEDETECTION_BASE_URL="http://your-instance:5000" \
  nicholaswilde/changedetection-mcp-rs:latest

⁠🤖 Configuration (Claude Desktop)

To use this server with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "changedetection": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CHANGEDETECTION_API_KEY=your_api_key_here",
        "-e", "CHANGEDETECTION_BASE_URL=http://your_instance_url:5000",
        "nicholaswilde/changedetection-mcp-rs:latest"
      ]
    }
  }
}

⁠⚙️ Environment Variables

⁠⚖️ License

This project is licensed under the Apache License 2.0.

Developed by Nicholas Wilde⁠.