@seo-audit/local-mcp

MCP (Model Context Protocol) server for SEO auditing that communicates over stdio.

Part of the seo-audit-mcp monorepo.

Quick Start

Run directly via bunx (no install required):

bunx @seo-audit/local-mcp

Or install and run:

npm install -g @seo-audit/local-mcp
seo-audit-mcp

Usage with Claude Desktop

Add to your claude.json:

{
  "mcpServers": {
    "seo-audit": {
      "command": "bunx",
      "args": ["@seo-audit/local-mcp"]
    }
  }
}

Or with Node.js (if installed globally):

{
  "mcpServers": {
    "seo-audit": {
      "command": "node",
      "args": ["-e", "require('@seo-audit/local-mcp')"]
    }
  }
}

Usage with OpenCode

Add to your opencode.json:

{
  "mcp": {
    "seo-audit": {
      "type": "local",
      "command": ["bunx", "@seo-audit/local-mcp"],
      "enabled": true
    }
  }
}

Available Tools

| Tool | Description | | ------------------------ | ---------------------------------------------------- | | audit | Run all SEO checks (or a subset) | | check_meta_tags | Check for missing or malformed meta tags | | check_sitemap | Validate the sitemap.xml | | check_robots_txt | Validate robots.txt | | check_broken_links | Find broken links on the page | | check_headings | Analyze heading (h1-h6) structure | | check_duplicate_titles | Check for duplicate or poorly formed titles | | check_keyword_density | Analyze keyword density on the page |

Tool Arguments

All tools accept:

| Argument | Type | Description | | ------------- | --------------------- | ---------------------------------- | | url | string (required) | Website URL to audit | | checks | string[] (optional) | Specific checks (audit tool only)| | concurrency | number (optional) | Link check concurrency (1-20) | | timeout | number (optional) | Request timeout in ms |

Local Development

# Build
cd packages/local-mcp && bun run build

# Run from source (no build needed)
bun run packages/local-mcp/src/index.ts

# Run built output
node packages/local-mcp/dist/index.js

For local Claude Desktop development with the monorepo:

{
  "mcpServers": {
    "seo-audit": {
      "command": "bun",
      "args": ["run", "/path/to/packages/local-mcp/src/index.ts"]
    }
  }
}

Published Package

npm: @seo-audit/local-mcp
bin: seo-audit-mcp