seo-mcp

@metricspot/mcp-server

适用于 MetricSpot 的模型上下文协议服务。向 AI Agent（Claude、ChatGPT、Gemini、Perplexity、Cursor、Zed、OpenClaw、自定义机器人）提供 6 种 SEO + AI 可读性审计工具。

• 托管的 Streamable HTTP 端点：https://mcp.metricspot.com/mcp
• 本地 stdio 二进制文件：npx @metricspot/mcp-server
• Agent 指南：https://metricspot.com/AGENTS.md

工具

工具	认证	描述
run_audit_anonymous	无	单次审计，每个 IP 每 24 小时 1 次，不包含 Core Web Vitals
run_audit	Bearer 密钥	完整审计，包含 PSI，返回 audit_id
get_audit	Bearer 密钥	按 ID 获取审计和发现结果
list_audits	Bearer 密钥	列出用户最近的审计（最多 100 条）
get_audit_pdf	Bearer 密钥	品牌 PDF 报告的签名 URL
get_organic_traffic	Bearer 密钥	28 天 GA4 + GSC 快照（需已关联 Google）

本地安装（stdio）

Claude Code（~/.claude/mcp.json）：

{
  "mcpServers": {
    "metricspot": {
      "command": "npx",
      "args": ["-y", "@metricspot/mcp-server"],
      "env": {
        "MCP_API_KEY": "ms_live_xxx"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）和 Zed 使用相同的格式。

省略 MCP_API_KEY 即可仅使用 run_audit_anonymous。

托管（Streamable HTTP）

POST https://mcp.metricspot.com/mcp
Authorization: Bearer ms_live_xxx
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

环境变量

变量	默认值	用途
PORT	3000	HTTP 监听端口
APP_API_BASE_URL	https://app.metricspot.com	MetricSpot 应用 API 基础 URL（dev/dev:stdio 脚本会将其覆盖为 http://localhost:3000）
APP_PUBLIC_BASE_URL	回退至 APP_API_BASE_URL	用于构建 report_url
MCP_INTERNAL_TOKEN	—	服务间密钥，以 X-MCP-Internal-Token 转发
MCP_API_KEY	—	（仅限 stdio）用户 API 密钥，以 Authorization: Bearer 发送至 HTTP 层

开发

bun install
bun run typecheck
bun test
bun run dev          # Streamable HTTP on :3000
bun run dev:stdio    # stdio loop (send JSON-RPC on stdin)

部署

多阶段 Dockerfile 会生成 Bun 运行时镜像。在与 app/ 和 web/ 相同的 Hetzner droplet 上运行独立的 Dokku 应用。

许可证

MIT