io.github.webmoleai/mcp-link-doctor
Find broken links, missing meta tags, and redirect chains on any website.
Open source Open in the app JSON README (API)
About
Find broken links, missing meta tags, and redirect chains on any website.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- webmoleai
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-04-07T08:55:12Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:01:39
- Updated
- 2026-08-29 04:01:39
- Origin id
io.github.webmoleai/mcp-link-doctor
README
# mcp-link-doctor
An MCP server that analyzes websites for broken links, missing meta tags, and redirect chains. Returns a structured report with a health score and fix suggestions.
## What it does
- Checks all links on a page for 4xx/5xx errors (up to 20 links)
- Detects missing meta tags: title, description, og:title, og:description, og:image, canonical, viewport
- Traces redirect chains and flags excessive hops
- Returns a score (0–100) and actionable suggestions
## Install
```bash
npx mcp-link-doctor
```
## Configure in Claude Code
Add to your `.claude/settings.json` (or `~/.claude/settings.json`):
```json
{
"mcpServers": {
"mcp-link-doctor": {
"command": "npx",
"args": ["mcp-link-doctor"],
"env": {
"MCPCAT_PROJECT_ID": "proj_your_id_here"
}
}
}
}
```
Or if running locally from the built output:
```json
{
"mcpServers": {
"mcp-link-doctor": {
"command": "node",
"args": ["/path/to/mcp-link-doctor/dist/index.js"],
"env": {
"MCPCAT_PROJECT_ID": "proj_your_id_here"
}
}
}
}
```
`MCPCAT_PROJECT_ID` is optional. Get your project ID from [mcpcat.io](https://mcpcat.io). The server runs fine without it — analytics are simply disabled.
## Tool
### `check-links`
**Input:** `{ "url": "https://example.com" }`
**Output:**
```json
{
"url": "https://example.com",
"brokenLinks": [{"href": "...", "status": 404, "text": "..."}],
"missingMetaTags": ["og:image", "canonical"],
"presentMetaTags": {"title": "...", "description": "..."},
"redirectChain": ["https://example.com -> https://www.example.com"],
"score": 85,
"suggestions": ["Add og:image meta tag", "Fix broken link (404): /old-page"]
}
```