Google Search Console MCP Server

Google Search Console MCP サーバー

Model Context Protocol（MCP）サーバーを使用して Google Search Console にアクセスするためのツールです。

機能

• 検索アナリティクスデータを取得します（ディメンションに対応）
• カスタマイズ可能なレポート期間で詳細なデータ分析を行います

前提条件

• Python 3.10 以降
• Search Console API を有効にした Google Cloud プロジェクト
• Search Console へのアクセス権を持つサービスアカウントの認証情報

インストール

pip install mcp-server-google-search-console

または、ソースからインストールします。

git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .

開発環境のセットアップ（uv）

このプロジェクトでは、パッケージ管理とインストールを高速化するために uv を使用します。

uv と uvx のインストール

まず、uv と uvx をインストールします。

pip install uv uvx

仮想環境の作成と管理

uv を使用して新しい仮想環境を作成するには、次のようにします。

uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate     # Windows

依存関係のインストール

リポジトリをクローンした後、依存関係をインストールします。

git clone https://github.com/yourusername/mcp-server-google-search-console.git
cd mcp-server-google-search-console
pip install -e .

MCP パッケージを個別にインストールするには、次のようにします。

pip install "mcp[cli]"

開発用依存関係のインストール

開発に必要な追加ツールをインストールするには、次のコマンドを実行します。

pip install -e ".[dev]"

認証のセットアップ

Google Search Console API の認証情報を取得するには、次の手順に従います。

1. Google Cloud Console にアクセスします
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
3. API を有効にします。
   • 「API とサービス」>「ライブラリ」に移動します
   • 「Search Console API」を検索して有効にします
4. 認証情報を作成します。
   • 「API とサービス」>「認証情報」に移動します
   • 「認証情報を作成」>「サービス アカウント」をクリックします
   • サービスアカウントの詳細を入力します
   • JSON 形式で新しいキーを作成します
   • 認証情報ファイル（.json）が自動的にダウンロードされます
5. アクセス権を付与します。
   • Search Console を開きます
   • サービスアカウントのメールアドレス（形式: [email protected]）をプロパティの管理者として追加します

使用方法

Google Search Console の認証情報ファイルへのパスを指定する環境変数を設定します。

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json

MCP サーバーの起動

標準的な方法

mcp-server-gsc

uvx を使用する場合

uvx を使用すると、仮想環境とパッケージのインストールを自動化できます。

# Run directly without installation
uvx run mcp-server-gsc

# Run with a specific Python version
uvx --python=3.11 run mcp-server-gsc

# Run with specified environment variables
uvx run -e GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json mcp-server-gsc

Claude Desktop アプリケーションの設定

標準的な設定

{
  "mcpServers": {
    "gsc": {
      "command": "mcp-server-gsc",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

uvx を使用した設定

{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": ["run", "mcp-server-gsc"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json"
      }
    }
  }
}

利用可能なツール

search_analytics

Google Search Console から検索パフォーマンスデータを取得します。

必須パラメーター:

• siteUrl: サイト URL（形式: http://www.example.com/ または sc-domain:example.com）
• startDate: 開始日（YYYY-MM-DD）
• endDate: 終了日（YYYY-MM-DD）

省略可能なパラメーター:

• dimensions: カンマ区切りのリスト（query,page,country,device,searchAppearance）
• type: 検索タイプ（web、image、video、news）
• aggregationType: 集計方法（auto、byNewsShowcasePanel、byProperty、byPage）
• rowLimit: 返される行の最大数（デフォルト: 1000）

使用例:

{
  "siteUrl": "https://example.com",
  "startDate": "2024-01-01",
  "endDate": "2024-01-31",
  "dimensions": "query,country",
  "type": "web",
  "rowLimit": 500
}

リリース手順

このプロジェクトは、GitHub のリリースタグが作成されると自動的に PyPI に公開されます。

新しいバージョンをリリースするには、次の手順に従います。

1. バージョン更新スクリプトを実行します。

   python scripts/bump_version.py [major|minor|patch]
   

2. 表示された手順に従って GitHub にプッシュします。

   git add pyproject.toml
   git commit -m "Bump version to x.y.z"
   git tag vx.y.z
   git push origin main vx.y.z
   

3. GitHub リポジトリのページでリリースを作成します。

   • タグを選択します: vx.y.z
   • タイトルを入力します: vx.y.z
   • リリースノートを記入します
   • 「公開」をクリックします

4. GitHub Actions が起動し、パッケージが自動的に PyPI に公開されます。

ライセンス

MIT

コントリビューション

コントリビューションを歓迎します。プルリクエストを送信する前に、コントリビューションガイドラインをお読みください。