seo-mcp

@metricspot/mcp-server

MetricSpot 用の Model Context Protocol サーバーです。AI エージェント（Claude、ChatGPT、Gemini、Perplexity、Cursor、Zed、OpenClaw、カスタムボット）に、SEO と AI の読みやすさを監査する 6 つのツールを提供します。

• ホスト型 Streamable HTTP エンドポイント：https://mcp.metricspot.com/mcp
• ローカル stdio バイナリ：npx @metricspot/mcp-server
• エージェントガイド：https://metricspot.com/AGENTS.md

ツール

ツール	認証	説明
run_audit_anonymous	なし	1 回限りの監査。1 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 のみ）HTTP レイヤーに Authorization: Bearer として送信されるユーザー API キー

開発

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 ドロップレット上で、独立した Dokku アプリとして動作します。

ライセンス

MIT