Linkinator MCP

Linkinator MCP 服务器

](https://www.npmjs.com/package/linkinator-mcp)   

一个模型上下文协议（MCP）服务器，提供使用（某种技术或方法）的链接检查功能 “linkinator”可以翻译为“链接捕捉器”或“链接生成器”，具体取决于其功能和用途。如果是指用于捕捉或生成链接的工具或程序，这样的翻译是合适的这使得像Claude这样的AI助手能够扫描网页和本地文件，查找死链接。

特点/功能

• 全面链接检查扫描网站和本地文件中的死链接
• 递归爬取遵循同一域名内的链接
• 多种内容类型检查HTML、CSS和Markdown文件中的链接
• 片段验证验证锚点链接和URL片段
• 灵活配置广泛的超时、重试、SSL 等选项
• 详细报告获取状态码、按错误类型分组的失效链接以及父页面信息

快速设置（自动）

开始的最简单方法是使用 install-mcp 该工具可自动为Claude Desktop、Claude Code、Cursor、Cline及其他MCP客户端配置linkinator-mcp：

npx install-mcp linkinator-mcp --client claude

这将自动处理所有配置。安装后请重启您的Claude客户端。

手动配置

如果您更倾向于手动配置服务器，可以直接编辑您的MCP客户端的配置文件。

克劳德·科德

macOS/Linux（可翻译为“Mac操作系统/类Unix操作系统中的Linux系统”或简称为“Mac/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客户端以使更改生效。

使用示例

配置完成后，您可以要求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）选项：

必需的

• 路径 (字符串)：要扫描的URL或本地文件路径

连接设置

• 并发性 (数字): 同时连接数（默认值：100）
• 港口 （数字）：本地扫描所用的服务器端口（默认为随机端口）
• 超时 (数字)：请求超时时间（毫秒）（0 = 无超时）

爬行行为

• 递归 (布尔值)：在同一个域上递归地跟随链接
• 服务器根目录 （字符串）：服务器启动时自定义的磁盘位置
• 目录列表 (boolean): 自动服务目录索引文件
• cleanUrls 翻译成中文是“清理URL”或“优化URL” (布尔值)：启用无扩展名链接解析（例如，/about → /about.html）

内容解析

• Markdown (布尔值): 解析和扫描Markdown文件
• 检查CSS (布尔值)：从CSS属性中提取并验证URL
• 检查碎片（或“检查片段”） (布尔值)：验证URL锚点标识符

过滤与定制

• 要跳过的链接 （字符串数组）：要排除的 URL 模式（正则表达式字符串）
• 用户代理（User Agent） (字符串): 自定义用户代理头部

重试逻辑

• 重试 (布尔值)：对带有 retry-after 头的 HTTP 429 响应进行重试
• 重试错误 (布尔值)：对5xx错误进行重试
• 重试错误计数 （数字）：重试尝试次数限制
• 重试错误抖动 (number): 重试之间的随机延迟（毫秒）

SSL与安全

• 允许不安全证书 (boolean): 接受无效的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代码中显示

1. 检查路径中的 config.json 是绝对的，而非相对的
2. 验证构建目录是否存在： ls /path/to/linkinator-mcp/build/index.js
3. 检查Claude代码日志中的错误
4. 确保 Node.js 已添加到你的系统路径中

权限错误

如果你在 macOS/Linux 上遇到权限错误：

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

端口已被占用

如果在扫描本地文件时遇到端口错误，请尝试指定一个端口：

Check /path/to/files with port 9000

贡献；做出贡献

欢迎投稿！详情请见 \CONTRIBUTING.md\ 翻译为中文是：“贡献指南.md” 或 “贡献规范.md”（具体翻译可能根据上下文有所调整，但基本意思是指该文件用于说明如何向项目做出贡献的指南或规范） 有关如何开始的详细信息。

许可证

麻省理工学院（MIT）

相关项目

• “linkinator”可以翻译为“链接器”或“链接解析器”，具体取决于上下文和该词在特定领域中的专业含义。如果它是指一种用于解析、处理或生成链接的工具或程序，那么“链接器”或“链接解析器”都是合适的翻译 - 基础的链路检查库
• MCP 服务器 - MCP服务器实现的集合
• 克劳德·科德 - 使用MCP的AI编码助手

作者

贾斯汀·贝克维奇

致谢

构建于 模型上下文协议 SDK（软件开发工具包）。