LinkRescue MCP 서버

깨진 링크를 빠르게 찾고, 영향도에 따라 우선순위를 지정하며, AI 에이전트가 수행할 수 있는 수정 제안을 생성하세요.

LinkRescue MCP는 깨진 링크 스캔, 모니터링 및 수정 워크플로우를 MCP(Model Context Protocol)를 통해 노출하므로, Claude나 Cursor와 같은 도구에서 직접 링크 상태 작업을 실행할 수 있습니다.

제공 기능

• check_broken_links: URL(또는 사이트맵)을 스캔하고 구조화된 깨진 링크 보고서를 반환합니다.

• monitor_links: 웹사이트에 대한 주기적인 모니터링을 설정합니다.

• get_fix_suggestions: 우선순위가 지정된 수정 권장 사항을 생성합니다.

• health_check: MCP 서버 및 백엔드 API 연결 상태를 확인합니다.

LinkRescue 백엔드 API에 연결할 수 없는 경우, 서버는 로컬 테스트 및 데모가 계속 작동하도록 현실적인 시뮬레이션 데이터로 대체합니다.

요구 사항

• 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 / 호스팅 플랫폼

Railway, Fly.io 및 기타 컨테이너 호스트를 위한 Dockerfile이 포함되어 있습니다.

# 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 도구 호출과 LinkRescue API 작업 간의 변환 계층입니다.

추가 README 변형

• 개발자 중심 버전: README.dev.md

• 마켓플레이스 중심 버전: README.marketplace.md