Servidor MCP LinkRescue

Encuentra enlaces rotos rápidamente, priorízalos por impacto y genera sugerencias de reparación sobre las que tu agente de IA pueda actuar.

LinkRescue MCP expone flujos de trabajo de escaneo, monitorización y remediación de enlaces rotos a través del Protocolo de Contexto de Modelo (MCP), para que herramientas como Claude y Cursor puedan ejecutar operaciones de salud de enlaces directamente.

Qué obtienes

• check_broken_links: escanea una URL (o sitemap) y devuelve un informe estructurado de enlaces rotos

• monitor_links: configura una monitorización recurrente para un sitio web

• get_fix_suggestions: genera recomendaciones de remediación priorizadas

• health_check: verifica la conectividad del servidor MCP y la API de backend

Si la API de backend de LinkRescue no está disponible, el servidor recurre a datos simulados realistas para que las pruebas locales y las demostraciones sigan funcionando.

Requisitos

• Python 3.11+

• pip

Inicio rápido

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

Endpoint MCP:

• http://localhost:8000/mcp

Configuración

Ejemplo:

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

Opciones de ejecución

Ejecutar directamente:

python main.py

Ejecutar a través de la CLI de FastMCP:

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

Conectar un cliente MCP

Claude Desktop

Añade esto a claude_desktop_config.json:

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

Claude Code

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

Pruébalo

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

Entradas y salidas de herramientas

check_broken_links

Entradas:

• url (obligatorio): URL del sitio a escanear

• sitemap_url (opcional): rastrear desde el sitemap

• max_depth (opcional, predeterminado 3): profundidad de rastreo

Devuelve metadatos del escaneo, detalles de enlaces rotos y estadísticas resumidas.

monitor_links

Entradas:

• url (obligatorio)

• frequency_hours (opcional, predeterminado 24)

Devuelve el ID de monitorización, detalles de programación y estado.

get_fix_suggestions

Entrada:

• informe completo de check_broken_links, o

• matriz broken_links sin procesar, o

• cadena JSON de cualquiera de los formatos

Devuelve acciones priorizadas y pasos de remediación sugeridos.

health_check

Sin entrada. Devuelve el estado del servidor y la accesibilidad de la API de backend.

Despliegue

Smithery

Este repositorio incluye smithery.yaml y smithery.json.

1. Envía el repositorio a GitHub

2. Crea/añade el servidor en Smithery

3. Apunta Smithery a este repositorio

Docker / Plataformas de alojamiento

Se incluye un Dockerfile para Railway, Fly.io y otros hosts de contenedores.

# Railway
railway up

# Fly.io
fly launch
fly deploy

Establece LINKRESCUE_API_BASE_URL y LINKRESCUE_API_KEY en tu entorno de host.

Arquitectura

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

Este servidor es una capa de traducción entre las llamadas a herramientas MCP y las operaciones de la API de LinkRescue.

Variantes adicionales del README

• Versión enfocada en desarrolladores: README.dev.md

• Versión enfocada en el mercado: README.marketplace.md