MCP Search Console

mcp-search-console

サーバーを再起動せずに、複数のサイトやクライアントにまたがる単一の MCP インターフェースを必要とする運用担当者向けの、複数アカウント対応 Google Search Console MCP サーバーです。

リリース状況：ベータ版パッケージ、pyproject.toml のバージョン 0.1.3。

利用目的に合わせて選択

対象	まずはこちら	次に
サーバーを Claude/Codex/Cursor に接続する	docs/start-here.md	以下のクイックスタート
アカウントのルーティングや破壊的操作のガードを監査する	docs/architecture.md	gsc/server.py
パッケージングやレジストリのメタデータを確認する	pyproject.toml	server.json

アーキテクチャ

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  S --> M[Account manager]
  M --> F[Accounts config]
  M --> A[OAuth or service-account auth]
  S --> R[Retry wrapper]
  R --> G[Google Search Console API]
  G --> R --> S

リクエストの流れ

flowchart TD
  P[Operator asks for analytics or indexing data] --> T[Selected MCP tool]
  T --> A[Resolve named or default account]
  A --> B[Build authenticated GSC client]
  B --> C[Call Search Console endpoint]
  C --> D{API call succeeds?}
  D -- yes --> E[Return normalized JSON]
  D -- retryable --> F[Backoff and retry]
  F --> D
  D -- no --> G[Return error payload]

クイックスタート

1. パッケージをインストールします。

python -m pip install mcp-search-console-multi

2. アカウント設定を作成します。

mkdir -p ~/.config/mcp-search-console
cp accounts.example.json ~/.config/mcp-search-console/accounts.json

3. MCP クライアントに登録します。

{
  "mcpServers": {
    "search-console": {
      "command": "uvx",
      "args": ["mcp-search-console-multi"],
      "env": {
        "GSC_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-search-console/accounts.json"
      }
    }
  }
}

利用可能なツール

ツールグループ	ツール	目的
アカウントのルーティング	list_accounts, set_default_account, reauthenticate	アカウントの確認、デフォルトの切り替え、認証情報の更新
プロパティの一覧	list_properties, get_site_details	アクセス可能なプロパティと権限の確認
検索アナリティクス	get_search_analytics, get_performance_overview, compare_periods, get_advanced_search_analytics, get_search_by_page	検索パフォーマンスデータの取得
検査とサイトマップ	inspect_url, batch_inspect_urls, check_indexing_issues, list_sitemaps, get_sitemap, submit_sitemap, delete_sitemap	インデックス登録状況の検査とサイトマップ送信の管理

submit_sitemap と delete_sitemap は、docs/start-here.md に記載されている破壊的操作フラグが有効な場合にのみ使用できます。

実行時の根拠

主張	根拠
パッケージのエントリポイントは安定しています	pyproject.toml の mcp-search-console-multi = "gsc.server:main"
複数アカウントのルーティングは主要機能として実装されています	gsc/server.py の AccountManager() と _get_manager()
Search Console の呼び出しは再試行されます	gsc/server.py と gsc/retry.py の with_retry()
認証情報はアカウントごとにファイルで管理されます	accounts.example.json と gsc/accounts.py

リポジトリの構成

パス	目的
gsc/server.py	FastMCP のツールインターフェースとレスポンスの正規化
gsc/accounts.py	アカウント設定、認証情報の読み込み、クライアントの構築
gsc/auth/	OAuth とサービスアカウントの認証実装
gsc/retry.py	一時的な API エラーに対する再試行動作
docs/start-here.md	セットアップ、環境設定、検証、よくある障害
docs/architecture.md	コンポーネント構成と実行時のライフサイクル

検証

チェック項目	コマンド
インポート時にコンパイルされる	python -m compileall gsc
パッケージをビルドできる	python -m build
README とドキュメントのリンクがローカルのままか確認する	rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

ライセンス

MIT

新しいタスク向けのプロジェクト情報

タスク固有の仕様を確認するには INDEX.md を参照してください。製品の方向性が関係する場合は prompt.md を確認してください。過去の例は、現在のタスクを決定するものではありません。