LinkRescue MCPサーバー

リンク切れを迅速に発見し、影響度に基づいて優先順位を付け、AIエージェントが実行可能な修正案を生成します。

LinkRescue MCPは、リンク切れのスキャン、監視、修復ワークフローをModel Context Protocol (MCP)を通じて公開するため、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