🚀 如何为Claude和Cursor构建Google Ads MCP（管理客户平台）
本项目是一个用于与Google Ads API交互的管理客户平台（MCP）的实现，允许您通过Claude Desktop和Cursor进行配置和控制，具备广告系列管理、广告组管理等多种核心功能。
🚀 快速开始
- 克隆仓库：
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 - 启动服务：
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/
常见问题解决
环境变量配置错误
- 检查
.env文件路径是否正确。 - 确保所有环境变量都已设置。
认证失败
- 验证Google Ads API凭据文件是否存在且内容正确。
- 确保Claude API密钥有效。
附录
示例配置文件config.json
{
"google_ads": {
"client_id": "your_client_id",
"client_secret": "your_client_secret"
},
"claude": {
"api_key": "your_api_key_here"
}
}
更多资源
📄 许可证
项目使用MIT许可证。请查看LICENSE文件获取详细信息。
📞 联系方式
如需反馈，请联系：
ernesto@ixigo.com