Google Ads API多服务器管理工具

一个支持多服务器切换的Google Ads API访问工具,集成MCP协议,适用于广告数据查询和账户管理。

  • by revspace7777
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 revspace7777/google-ads-mcp-official_main

使用说明

Google Ads MCP服务器项目

支持MCP(模型上下文协议)集成的Google Ads API多服务器访问设置。

快速入门

活动MCP服务器

  • CDATA 服务器 (GoogleAds) - Windows 可执行文件
  • 官方服务器 (GoogleAds-Official) - 基于Python的GitHub实现

先决条件

  1. 带有MCP支持的Cursor或VS Code
  2. Google Ads API凭证已配置在 google-ads.yaml
  3. 对于CDATA:以管理员身份运行PowerShell
  4. 对于官方: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 以获取完整列表。