MCP-сервер LinkRescue

Быстро находите неработающие ссылки, расставляйте приоритеты по степени их влияния и генерируйте предложения по исправлению, которые может выполнить ваш ИИ-агент.

LinkRescue MCP предоставляет рабочие процессы сканирования, мониторинга и исправления неработающих ссылок через протокол Model Context Protocol (MCP), благодаря чему такие инструменты, как Claude и Cursor, могут напрямую выполнять операции по проверке состояния ссылок.

Что вы получаете

• check_broken_links: сканирование URL (или карты сайта) и получение структурированного отчета о неработающих ссылках

• monitor_links: настройка регулярного мониторинга веб-сайта

• get_fix_suggestions: генерация рекомендаций по исправлению с учетом приоритетов

• health_check: проверка работоспособности MCP-сервера и подключения к бэкенд-API

Если бэкенд-API LinkRescue недоступен, сервер переключается на реалистичные симулированные данные, чтобы локальное тестирование и демонстрации продолжали работать.

Требования

• Python 3.11+

• pip

Быстрый старт

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

MCP-эндпоинт:

• http://localhost:8000/mcp

Конфигурация

Пример:

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

Варианты запуска

Запуск напрямую:

python main.py

Запуск через FastMCP CLI:

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

Подключение MCP-клиента

Claude Desktop

Добавьте это в claude_desktop_config.json:

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

Claude Code

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

Попробуйте

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

Входные и выходные данные инструментов

check_broken_links

Входные данные:

• url (обязательно): URL сайта для сканирования

• sitemap_url (опционально): сканирование по карте сайта

• max_depth (опционально, по умолчанию 3): глубина сканирования

Возвращает метаданные сканирования, подробную информацию о неработающих ссылках и сводную статистику.

monitor_links

Входные данные:

• url (обязательно)

• frequency_hours (опционально, по умолчанию 24)

Возвращает ID мониторинга, детали расписания и статус.

get_fix_suggestions

Входные данные:

• полный отчет из check_broken_links, или

• массив broken_links в исходном виде, или

• JSON-строка в любом из этих форматов

Возвращает приоритизированные действия и предложенные шаги по исправлению.

health_check

Без входных данных. Возвращает статус сервера и доступность бэкенд-API.

Развертывание

Smithery

Этот репозиторий включает smithery.yaml и smithery.json.

1. Отправьте репозиторий на GitHub

2. Создайте/добавьте сервер в Smithery

3. Укажите Smithery путь к этому репозиторию

Docker / Хостинг-платформы

Dockerfile включен для Railway, Fly.io и других хостингов контейнеров.

# Railway
railway up

# Fly.io
fly launch
fly deploy

Установите LINKRESCUE_API_BASE_URL и LINKRESCUE_API_KEY в среде вашего хоста.

Архитектура

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

Этот сервер является уровнем трансляции между вызовами инструментов MCP и операциями API LinkRescue.

Дополнительные варианты README

• Версия для разработчиков: README.dev.md

• Версия для маркетплейса: README.marketplace.md