MCP Google Ads

🚀 如何為Claude和Cursor構建Google Ads MCP（管理客戶平臺）

本項目是一個用於與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性能報告。
• 批量操作：支持大規模數據的批量處理。

📦 安裝指南

克隆項目

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

安裝依賴

pip install -r requirements.txt

配置環境

創建並編輯.env文件：

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

💻 使用示例

使用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中註冊您的服務： 創建新的Python文件claude_plugin.py：

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

基礎用法

在Cursor中使用MCP，創建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"
    ]
)

📚 詳細文檔

項目結構

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                  # 項目說明文檔

測試

環境變量配置

編輯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