English Français العربية

ai.snapdiff/mcp

السجل الرسمي أدوات المطورين

Visual-diff & change-detection tools that catch agentic UI drift for coding agents.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @corralimited/snapdiff-mcp
Claude Code 
claude mcp add ai-snapdiff-mcp -e 'SNAPDIFF_API_KEY=<your snapdiff_api_key>' -e 'SNAPDIFF_API_URL=<SNAPDIFF_API_URL>' -- npx -y @corralimited/snapdiff-mcp@0.5.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ai-snapdiff-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@corralimited/snapdiff-mcp@0.5.0"
            ],
            "env": {
                "SNAPDIFF_API_KEY": "<your snapdiff_api_key>",
                "SNAPDIFF_API_URL": "<SNAPDIFF_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • SNAPDIFF_API_KEY إلزامي سري SnapDiff API key. Get one at https://snapdiff.ai/dashboard.
  • SNAPDIFF_API_URL Override the API base URL. Defaults to https://api.snapdiff.ai/v1.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @corralimited/snapdiff-mcp
  2. Quickstart
  3. Tools
  4. Remote HTTP access
  5. Configuration
  6. License

@corralimited/snapdiff-mcp

Standalone MCP server for SnapDiff. Exposes four tools to local agents:

  • Compare two web pages visually — diff percentage plus a highlighted diff image
  • Capture a screenshot of any URL
  • Check whether a page changed vs. a previous capture
  • Render HTML/CSS to an image (OG cards, social images, email headers)

Hits the public SnapDiff REST API. Bring your own API key.

Quickstart

Get an API key at https://snapdiff.ai/dashboard, then drop the snippet for your agent below.

Claude Code
claude mcp add snapdiff -e SNAPDIFF_API_KEY=sk_live_... -- npx -y @corralimited/snapdiff-mcp

Or edit ~/.claude/settings.json:

{
  "mcpServers": {
    "snapdiff": {
      "command": "npx",
      "args": ["-y", "@corralimited/snapdiff-mcp"],
      "env": { "SNAPDIFF_API_KEY": "sk_live_..." }
    }
  }
}
Cursor

~/.cursor/mcp.json (or project-level .cursor/mcp.json):

{
  "mcpServers": {
    "snapdiff": {
      "command": "npx",
      "args": ["-y", "@corralimited/snapdiff-mcp"],
      "env": { "SNAPDIFF_API_KEY": "sk_live_..." }
    }
  }
}
Cline (VS Code)

Cline > MCP Servers > Edit Config:

{
  "mcpServers": {
    "snapdiff": {
      "command": "npx",
      "args": ["-y", "@corralimited/snapdiff-mcp"],
      "env": { "SNAPDIFF_API_KEY": "sk_live_..." }
    }
  }
}
Zed

~/.config/zed/settings.json:

{
  "context_servers": {
    "snapdiff": {
      "command": {
        "path": "npx",
        "args": ["-y", "@corralimited/snapdiff-mcp"],
        "env": { "SNAPDIFF_API_KEY": "sk_live_..." }
      }
    }
  }
}
Continue

~/.continue/config.yaml:

mcpServers:
  - name: snapdiff
    command: npx
    args: ["-y", "@corralimited/snapdiff-mcp"]
    env:
      SNAPDIFF_API_KEY: sk_live_...
Anything else with a generic stdio MCP slot
command: npx
args:    -y @corralimited/snapdiff-mcp
env:     SNAPDIFF_API_KEY=sk_live_...

Tools

NamePurpose
snapdiff_verify_ui_changeChecks whether a visual change matches the agent's stated intent. Returns verdict (pass / expected_change_detected / unexpected_regression / no_change_detected / needs_human_review) and a next_action. Requires a project + baseline. Use this in the verification loop.
snapdiff_compare_pagesRaw visual diff between two URLs, or a URL vs. a stored project baseline. Use for ad-hoc diffs that don't fit the verify-ui-change verdict shape.
snapdiff_capture_screenshotSingle screenshot of a URL.
snapdiff_html_to_imageRender HTML/CSS to an image (OG cards, social images, email headers).

Schemas live in src/tools/ and are exported from @corralimited/snapdiff-mcp/tools. The hosted SnapDiff backend imports the same schemas so its in-process /mcp endpoint and this standalone stdio server expose an identical surface — agents see the same tool names, descriptions, and parameters whether they connect to https://api.snapdiff.ai/mcp or run this server locally.

Remote HTTP access

This package speaks stdio only — your editor spawns it as a subprocess, and the Playwright-backed localhost tools run on your machine, where your dev server actually is. It does not open a port.

If you need an HTTP endpoint, use the hosted one at https://mcp.snapdiff.ai/mcp, which authenticates every request with your API key and exposes the same tool surface.

Configuration

Env varRequiredNotes
SNAPDIFF_API_KEYyesGet one at https://snapdiff.ai/dashboard
SNAPDIFF_API_URLnoOverride the API base. Defaults to https://api.snapdiff.ai/v1.

There are no CLI flags beyond --help.

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو ai.snapdiff/mcp؟

Visual-diff & change-detection tools that catch agentic UI drift for coding agents.

كيف أثبّت ai.snapdiff/mcp؟

يعمل على جهازك. في Claude Code: claude mcp add ai-snapdiff-mcp -e 'SNAPDIFF_API_KEY=<your snapdiff_api_key>' -e 'SNAPDIFF_API_URL=<SNAPDIFF_API_URL>' -- npx -y @corralimited/snapdiff-mcp@0.5.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.snapdiff/mcp إلى مفتاح API؟

نعم. يتطلب SNAPDIFF_API_KEY، وتضبطها في إعداداته.

هل ai.snapdiff/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ai.snapdiff/mcp؟

ينشره corralimited. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.