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构建。