Linkinator MCP

🚀 Linkinator MCP Server

linkinator を使用してリンクチェック機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。これにより、Claude などの AI アシスタントがウェブページやローカルファイルの壊れたリンクをスキャンできます。

🚀 クイックスタート

自動セットアップ

最も簡単な開始方法は、install-mcp ツールを使用することです。これにより、Claude Desktop、Claude Code、Cursor、Cline などの MCP クライアントに対して linkinator-mcp が自動的に構成されます。

npx install-mcp linkinator-mcp --client claude

これによりすべての設定が自動的に処理されます。インストール後、Claude クライアントを再起動してください。

手動設定

サーバーを手動で構成する場合は、MCP クライアントの設定ファイルを直接編集することができます。

Claude Code

macOS/Linux

~/.config/claude-code/config.json を編集します。

{
  "mcpServers": {
    "linkinator": {
      "command": "npx",
      "args": ["linkinator-mcp"]
    }
  }
}

Windows

%APPDATA%\claude-code\config.json を編集します。

{
  "mcpServers": {
    "linkinator": {
      "command": "npx",
      "args": ["linkinator-mcp"]
    }
  }
}

代替方法: グローバルインストール

npm install -g linkinator-mcp でパッケージをグローバルにインストールすることを選択した場合、設定を簡略化できます。

{
  "mcpServers": {
    "linkinator": {
      "command": "linkinator-mcp"
    }
  }
}

Claude Desktop

macOS/Linux

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "linkinator": {
      "command": "npx",
      "args": ["linkinator-mcp"]
    }
  }
}

Windows

%APPDATA%\Claude\claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "linkinator": {
      "command": "npx",
      "args": ["linkinator-mcp"]
    }
  }
}

クライアントの再起動

設定を更新した後、変更を有効にするために Claude クライアントを再起動してください。

✨ 主な機能

• 包括的なリンクチェック：ウェブサイトとローカルファイルの壊れたリンクをスキャンします。
• 再帰的クローリング：同じドメイン内のリンクをたどります。
• 複数のコンテンツタイプ：HTML、CSS、Markdown ファイル内のリンクをチェックします。
• フラグメント検証：アンカーリンクと URL フラグメントを検証します。
• 柔軟な設定：タイムアウト、リトライ、SSL などの幅広いオプションがあります。
• 詳細なレポート：ステータスコード、エラータイプ別にグループ化された壊れたリンク、および親ページの情報を取得します。

💻 使用例

設定が完了したら、Claude に任意のウェブページやローカルファイルのリンクをチェックするように依頼できます。以下はいくつかの例です。

基本的なリンクチェック

Check all the links on https://example.com

再帰的スキャン

Scan https://example.com recursively and check all links on the same domain

ローカルファイルのチェック

Check the links in /path/to/my/documentation/index.html

高度なオプション

Check https://example.com with the following options:
- Recurse through all pages
- Check CSS for URLs
- Validate anchor fragments
- Skip links to google.com and facebook.com
- Use a 10 second timeout

📚 ドキュメント

利用可能なオプション

scan_page ツールは、linkinator のすべての CLI オプションをサポートしています。

必須

• path (文字列): スキャンする URL またはローカルファイルのパス

接続設定

• concurrency (数値): 同時接続数（デフォルト: 100）
• port (数値): ローカルスキャン用のサーバーポート（デフォルトはランダムポート）
• timeout (数値): リクエストのタイムアウト時間（ミリ秒）（0 = タイムアウトなし）

クローリング動作

• recurse (真偽値): 同じドメイン内のリンクを再帰的にたどる
• serverRoot (文字列): サーバーが開始するカスタムディスクの場所
• directoryListing (真偽値): ディレクトリインデックスファイルを自動的に提供する
• cleanUrls (真偽値): 拡張子のないリンク解決を有効にする（例: /about → /about.html）

コンテンツ解析

• markdown (真偽値): Markdown ファイルを解析してスキャンする
• checkCss (真偽値): CSS プロパティ内の URL を抽出して検証する
• checkFragments (真偽値): URL アンカー識別子を検証する

フィルタリングとカスタマイズ

• linksToSkip (文字列配列): 除外する URL パターン（正規表現文字列）
• userAgent (文字列): カスタムユーザーエージェントヘッダー

リトライロジック

• retry (真偽値): retry-after ヘッダーを持つ HTTP 429 レスポンスをリトライする
• retryErrors (真偽値): 5xx エラーをリトライする
• retryErrorsCount (数値): リトライ試行回数の制限
• retryErrorsJitter (数値): リトライ間のランダムな遅延時間（ミリ秒）

SSL とセキュリティ

• allowInsecureCerts (真偽値): 無効な SSL 証明書を受け入れる

出力形式

ツールは次のような形式のレポートを返します。

Linkinator Scan Results for: https://example.com

Summary:
  Status: ✓ PASSED / ✗ FAILED
  Total Links: 150
  OK: 145
  Broken: 5
  Skipped: 0

Broken Links:

  Status 404:
    - https://example.com/missing-page
      Found on: https://example.com/index.html
    - https://example.com/old-blog-post
      Found on: https://example.com/blog.html

  Status 500:
    - https://api.example.com/endpoint
      Found on: https://example.com/docs.html

🔧 トラブルシューティング

Claude Code にサーバーが表示されない場合

1. config.json 内のパスが相対パスではなく絶対パスであることを確認します。
2. ビルドディレクトリが存在することを確認します: ls /path/to/linkinator-mcp/build/index.js
3. Claude Code のログにエラーがないことを確認します。
4. Node.js が PATH に含まれていることを確認します。

パーミッションエラー

macOS/Linux でパーミッションエラーが発生した場合:

chmod +x /path/to/linkinator-mcp/build/index.js

ポートが既に使用されている場合

ローカルファイルをスキャンしてポートエラーが発生した場合は、ポートを指定してみてください。

Check /path/to/files with port 9000

🤝 コントリビューション

コントリビューションは大歓迎です！開始方法の詳細については CONTRIBUTING.md を参照してください。

📄 ライセンス

MIT

関連プロジェクト

• linkinator - 基盤となるリンクチェックライブラリ
• MCP Servers - MCP サーバー実装のコレクション
• Claude Code - MCP を使用する AI コーディングアシスタント

作者

Justin Beckwith justin.beckwith@gmail.com

謝辞

Model Context Protocol SDK を使用して構築されています。