Linkinator MCP

🚀 Linkinator MCP Server

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選項：

輸出格式

該工具返回格式化報告，顯示如下信息：

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已添加到系統路徑中。

權限錯誤

若在macOS/Linux上遇到權限錯誤，可執行以下命令：

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

端口已被使用

若在掃描本地文件時遇到端口錯誤，可嘗試指定端口：

Check /path/to/files with port 9000

📄 許可證

本項目採用MIT許可證。

相關項目

• linkinator - 底層鏈接檢查庫
• MCP Servers - MCP服務器實現集合
• Claude Code - 使用MCP的AI編碼助手

作者

Justin Beckwith justin.beckwith@gmail.com

致謝

本項目基於Model Context Protocol SDK構建。