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代码中显示
- 检查路径中的
config.json是绝对的，而非相对的 - 验证构建目录是否存在：
ls /path/to/linkinator-mcp/build/index.js - 检查Claude代码日志中的错误
- 确保 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（软件开发工具包）。