LinkRescue MCP-Server

Finden Sie defekte Links schnell, priorisieren Sie nach Auswirkungen und generieren Sie Korrekturvorschläge, die Ihr KI-Agent umsetzen kann.

LinkRescue MCP stellt Workflows zur Suche, Überwachung und Behebung defekter Links über das Model Context Protocol (MCP) bereit, sodass Tools wie Claude und Cursor Link-Health-Operationen direkt ausführen können.

Was Sie erhalten

• check_broken_links: Scannt eine URL (oder Sitemap) und gibt einen strukturierten Bericht über defekte Links zurück

• monitor_links: Richtet eine wiederkehrende Überwachung für eine Website ein

• get_fix_suggestions: Generiert priorisierte Korrekturempfehlungen

• health_check: Überprüft die Konnektivität des MCP-Servers und der Backend-API

Wenn die LinkRescue-Backend-API nicht erreichbar ist, greift der Server auf realistische simulierte Daten zurück, damit lokale Tests und Demos weiterhin funktionieren.

Anforderungen

• Python 3.11+

• pip

Schnellstart

git clone https://github.com/carsonroell-debug/linkrescue-mcp.git
cd linkrescue-mcp
pip install -r requirements.txt
python main.py

MCP-Endpunkt:

• http://localhost:8000/mcp

Konfiguration

Beispiel:

export LINKRESCUE_API_BASE_URL="https://your-api.example.com/api/v1"
export LINKRESCUE_API_KEY="your-api-key"
python main.py

Ausführungsoptionen

Direkt ausführen:

python main.py

Ausführen über FastMCP CLI:

fastmcp run main.py --transport streamable-http --port 8000

Einen MCP-Client verbinden

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "linkrescue": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Claude Code

claude mcp add linkrescue --transport http http://localhost:8000/mcp

Ausprobieren

fastmcp list-tools main.py
fastmcp call-tool main.py health_check '{}'
fastmcp call-tool main.py check_broken_links '{"url":"https://example.com"}'

Tool-Eingaben und -Ausgaben

check_broken_links

Eingaben:

• url (erforderlich): zu scannende Website-URL

• sitemap_url (optional): Crawling von Sitemap

• max_depth (optional, Standard 3): Crawling-Tiefe

Gibt Scan-Metadaten, Details zu defekten Links und zusammenfassende Statistiken zurück.

monitor_links

Eingaben:

• url (erforderlich)

• frequency_hours (optional, Standard 24)

Gibt die Überwachungs-ID, Zeitplandetails und den Status zurück.

get_fix_suggestions

Eingabe:

• vollständiger Bericht von check_broken_links, oder

• rohes broken_links-Array, oder

• JSON-String in einem der beiden Formate

Gibt priorisierte Aktionen und vorgeschlagene Korrekturschritte zurück.

health_check

Keine Eingabe. Gibt den Serverstatus und die Erreichbarkeit der Backend-API zurück.

Bereitstellung

Smithery

Dieses Repository enthält smithery.yaml und smithery.json.

1. Repository auf GitHub pushen

2. Server in Smithery erstellen/hinzufügen

3. Smithery auf dieses Repository verweisen

Docker / Hosting-Plattformen

Ein Dockerfile ist für Railway, Fly.io und andere Container-Hosts enthalten.

# Railway
railway up

# Fly.io
fly launch
fly deploy

Setzen Sie LINKRESCUE_API_BASE_URL und LINKRESCUE_API_KEY in Ihrer Host-Umgebung.

Architektur

Agent (Claude, Cursor, etc.)
  -> MCP
LinkRescue MCP Server (this repo)
  -> HTTP API
LinkRescue Backend API

Dieser Server ist eine Übersetzungsschicht zwischen MCP-Tool-Aufrufen und LinkRescue-API-Operationen.

Zusätzliche README-Varianten

• Entwicklerorientierte Version: README.dev.md

• Marktplatzorientierte Version: README.marketplace.md