MCP Server Google Search Console

🚀 Google 検索コンソール MCP サーバー

このツールは、モデルコンテキストプロトコル（MCP）サーバーを使用して Google 検索コンソールにアクセスするためのものです。

✨ 主な機能

• 検索分析データの取得（次元に対応）
• 詳細なデータ表示とカスタムレポート周期分析

📦 インストール

パッケージを使用したインストール

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 .

📚 詳細ドキュメント

前提条件

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

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

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

uv と uvx のインストール

pip install uv uvx

仮想環境の作成と管理

新しい仮想環境を作成するには：

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 検索コンソール API の認証情報を取得するには：

1. Google Cloud Console にアクセスします。
2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
3. API を有効にします：
   • 「APIs & サービス」>「ライブラリ」に移動します。
4. 検索コンソールへのアクセス権を持つサービスアカウントを作成し、JSON 認証情報ファイルをダウンロードします。

使用方法

基本的な使用法

# パッケージのインストール
pip install mcp-server-google-search-console

# 実行例
python -m mcp_server.search_console_demo

利用可能なツール

検索コンソール API の呼び出し

Google 検索コンソールの API を呼び出すには、以下の手順に従います：

1. 依存関係のインストール

pip install google-api-python-client google-auth_oauthlib

2. プロジェクトの設定 config.py ファイルを作成します：

import os
from google.oauth2 import service_account

# サービスアカウントの認証情報を読み込む
credential_path = os.path.join(os.getcwd(), "service-account.json")
credentials = service_account.Credentials.from_service_account_file(
    credential_path, scopes=["https://www.googleapis.com/auth/searchconsole"])

3. MCP サーバーの作成

from mcp_server.search_console import SearchConsoleMCP

# MCP サーバーを初期化する
search_console = SearchConsoleMCP(config)

リリース手順

このプロジェクトは、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

🔧 コントリビューション

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