MCP Google Ads

🚀 Google Ads MCP（管理顧客プラットフォーム）をClaudeとCursor用に構築する方法

このプロジェクトは、Google Ads APIとやり取りする管理顧客プラットフォーム（MCP）を実装しています。Claude DesktopとCursorを通じて設定と制御が可能です。

🚀 クイックスタート

1. リポジトリのクローン

git clone https://github.com/your-username/google-ads-mcp.git
cd google-ads-mcp

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

pip install -r requirements.txt

3. 環境変数の設定

.envファイルを作成して編集します。

GOOGLE_ADS_CREDENTIALS_PATH=/path/to/your/google-ads.json
CLAUDE_API_KEY=your_api_key_here

4. サービスの起動

python -m google_ads_mcp.mcp --config config.json

✨ 主な機能

• 広告キャンペーン管理：広告キャンペーンの作成、読み取り、更新、削除が可能です。
• 広告グループ管理：広告グループの操作（追加、更新、削除）ができます。
• キーワード管理：広告キーワードの管理と最適化が可能です。
• レポート生成：Google Adsの性能レポートを自動生成します。
• 一括操作：大量のデータを一括で処理することができます。

📦 インストール

プロジェクト構造

google-ads-mcp/
├── google_ads_mcp/
│   ├── __init__.py
│   ├── mcp.py                 # 核心MCP実装
│   ├── services/             # すべてのサービスの定義
│   │   └── ads_service.py    # Google Ads APIサービス
│   └── tests/               # テストファイル
│       ├── test_google_ads_mcp.py  # 主要なテストファイル
│       └── test_token_refresh.py   # 認証とトークンの更新テスト
├── .env                       # 環境変数ファイル
├── config.json                # MCP設定ファイル
├── requirements.txt           # プロジェクトの依存関係
└── README.md                  # プロジェクトの説明ドキュメント

💻 使用例

基本的な使用法

Claude Desktopとの統合

google_ads_mcp/mcp.pyにClaude API呼び出しを追加します。

from claude_api import ClaudeAPI

class GoogleAdsMCP:
    def __init__(self):
        self.claude = ClaudeAPI(your_api_key)

    # 他のメソッド...

Caulde Desktopでサービスを登録します。

from google_ads_mcp.mcp import GoogleAdsMCP

class GoogleAdsPlugin:
    def __init__(self, api_key):
        self.mcp = GoogleAdsMCP()

    def get_advertising_campaigns(self):
        return self.mcp.list_campaigns()

Cursorでの使用

google_ads_mcp/cursor_extension.pyを作成します。

from .mcp import GoogleAdsMCP

class GoogleAdsExtension:
    def __init__(self):
        self.mcp = GoogleAdsMCP()

    def get_campaigns(self):
        return self.mcp.list_campaigns()

プロジェクトのルートディレクトリにsetup.pyを作成します。

from setuptools import setup, find_packages

setup(
    name="google-ads-mcp",
    version="1.0.0",
    packages=find_packages(),
    install_requires=[
        "google-ads",
        "claude_api"
    ]
)

🔧 テスト

環境変数の設定

tests/test_google_ads_mcp.pyを編集します。

import os
from unittest.mock import patch
from google_ads_mcp.mcp import GoogleAdsMCP

def test_init():
    with patch.dict('os.environ', {
        'GOOGLE_ADS_CREDENTIALS_PATH': '/path/to/google-ads.json',
        'CLAUDE_API_KEY': 'test_key'
    }):
        mcp = GoogleAdsMCP()
        assert mcp.credentials_path == '/path/to/google-ads.json'
        assert mcp.claude_api_key == 'test_key'

テストの実行

以下のコマンドを実行します。

python -m pytest tests/

📚 ドキュメント

よくある問題の解決

環境変数の設定エラー

1. .envファイルのパスが正しいことを確認してください。
2. すべての環境変数が設定されていることを確認してください。

認証失敗

1. Google Ads APIの認証情報ファイルが存在し、内容が正しいことを検証してください。
2. Claude APIキーが有効であることを確認してください。

付録

サンプル設定ファイルconfig.json

{
    "google_ads": {
        "client_id": "your_client_id",
        "client_secret": "your_client_secret"
    },
    "claude": {
        "api_key": "your_api_key_here"
    }
}

その他のリソース

• Google Ads APIドキュメント
• Claude APIドキュメント

📄 ライセンス

このプロジェクトはMITライセンスを使用しています。詳細はLICENSEファイルを参照してください。

📞 連絡先

フィードバックがある場合は、以下のアドレスまでご連絡ください。

ernesto@ixigo.com