Google Ads MCP Server
2025.04.18
4
Python广告管理数据可视化金融服务
Google Ads MCP Server 是一个模型上下文协议（MCP）服务器，通过 Claude Desktop 提供对 Google Ads 数据的访问。它允许用户查询和管理 Google Ads 的广告活动、账户和性能指标，支持多环境部署和容器化部署。
View on GitHub
Overview
基本能力
产品定位
Google Ads MCP Server 是一个专门用于访问和管理 Google Ads 数据的 MCP 服务器，通过与 Claude Desktop 集成，提供数据可视化和查询功能。
核心功能
- 访问 Google Ads 的广告活动、账户和性能指标
- 支持管理账户（MCC）和客户账户数据
- 内置缓存以提高性能并减少 API 调用
- Claude Artifacts 集成，支持数据可视化
- 多环境支持（开发、测试、生产）
- 容器化部署（Docker）
适用场景
- 广告性能监控和分析
- 广告活动管理和优化
- 数据可视化报告生成
工具列表
- Claude Desktop：用于与 MCP 服务器交互和数据可视化
- Docker：用于容器化部署
- Kubernetes：用于生产环境部署
常见问题解答
- 如何配置 Google Ads API 凭证？
在
.env文件中配置 Google Ads API 凭证。 - 如何启用多环境支持？
通过设置
APP_ENV环境变量为dev、test或prod。 - 如何集成 Claude Desktop？ 在 Claude Desktop 的配置文件中添加 MCP 服务器的路径和参数。
使用教程
使用依赖
- Python 3.9 或更高版本
- Google Ads API 凭证
- Claude Desktop
安装教程
- 克隆仓库：
git clone https://github.com/yourusername/google-ads-mcp.git cd google-ads-mcp - 设置虚拟环境：
python -m venv .venv source .venv/bin/activate # Windows 使用: .venv\Scripts\activate - 安装依赖：
pip install -r requirements.txt - 配置
.env文件：cp .env.example .env # 编辑 .env 文件填入凭证 - 运行服务器：
python server.py
Docker 部署
- 构建 Docker 镜像：
docker build -t google-ads-mcp:latest . - 运行容器：
docker run -p 8000:8000 --env-file .env google-ads-mcp:latest或使用 docker-compose：docker-compose up -d
调试方式
- 检查服务器是否运行：
curl http://localhost:8000/health - 查看日志：
docker logs <container_id> - 测试 Claude Desktop 集成： 在 Claude Desktop 中查询 Google Ads 数据，如 "Show me my Google Ads account performance"。