Google Ads MCP服务器项目
支持MCP(模型上下文协议)集成的Google Ads API多服务器访问设置。
快速入门
活动MCP服务器
- CDATA 服务器 (
GoogleAds) - Windows 可执行文件 - 官方服务器 (
GoogleAds-Official) - 基于Python的GitHub实现
先决条件
- 带有MCP支持的Cursor或VS Code
- Google Ads API凭证已配置在
google-ads.yaml - 对于CDATA:以管理员身份运行PowerShell
- 对于官方:Python 3.12+ 及其依赖项已安装
项目结构
google-ads-mcp/
├── clients/ # Client-specific work
│ ├── ocean-movers/ # Ocean Movers Main (active)
│ └── README.md
├── official-google-ads-mcp/ # Official MCP server
├── archive/ # Archived setup files
├── google-ads.yaml # API credentials (DO NOT COMMIT)
├── customer_ids.txt # Customer ID reference
├── mcp-config.json # Server switching config
├── switch-mcp-server.py # Switch between servers
├── test-mcp-servers.py # Test both servers
└── MCP-SETUP-GUIDE.md # Detailed setup guide
使用方法
切换MCP服务器
# List available servers
python switch-mcp-server.py list
# Switch to CDATA server
python switch-mcp-server.py switch GoogleAds-CDATA
# Switch to official server
python switch-mcp-server.py switch GoogleAds-Official
# Check current server
python switch-mcp-server.py current测试服务器
python test-mcp-servers.py查询Google Ads数据
"List all campaigns for Ocean Movers Main"
"Show performance metrics for customer 1556744976"
"Get ad groups for campaign [CAMPAIGN_ID]"客户账户
见 clients/README.md 以获取管理账户的完整列表。
激活:
- 海洋搬运主力:
1556744976
可用:
- T&E搬运与仓储服务:
5840144764 - B&B搬家公司
2111371572 - 678 摆脱破烂货:
8640190225 - 杰克逊维尔的搬家公司与仓储服务:
7283506172 - 国际劳工组织(ILO)的电器维修服务:
5727024154 - 殖民地卡车运输保险:
2452257371
文档
MCP-SETUP-GUIDE.md- 完整的安装说明clients/README.md- 客户账户参考信息clients/ocean-movers/README.md- Ocean Movers 特定(或:专有的 Ocean Movers)
安全
不要提交:
google-ads.yaml(包含API凭据)- 任何文件在
archive/目录 - 包含敏感信息的客户特定数据
看见 .gitignore 以获取完整列表。
