使用说明

项目简介

Google Ads MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用，它允许 Claude 等 MCP 客户端安全、便捷地访问和操作 Google Ads (原 Google AdWords) 的数据。通过此服务器，用户可以直接在 Claude 中查询广告系列的效果、账户信息等，并进行数据可视化。

主要功能点

Google Ads 数据访问: 通过 Claude 访问 Google Ads 账户和广告系列数据，包括效果指标、账户层级等。
多账户支持: 支持 Google Ads Manager Account (MCC) 和客户账户的数据访问。
性能优化: 内置缓存机制，减少 API 调用，提升数据访问速度和效率。
数据可视化: 与 Claude Artifacts 集成，支持在 Claude 中直接生成数据可视化图表。
灵活部署: 支持本地开发、Docker 容器化部署和 Kubernetes 部署，适应不同环境需求。
安全可靠: 安全存储凭据，支持速率限制，遵循容器安全最佳实践。

安装步骤

克隆仓库

git clone https://github.com/bjorndavidhansen/google-ads-mcp-server.git
cd google-ads-mcp-server

配置 Python 虚拟环境

python -m venv .venv
source .venv/bin/activate   # Linux 或 macOS
.venv\Scripts\activate  # Windows

安装依赖

pip install -r requirements.txt

配置 Google Ads API 凭据
- 复制 '.env.example' 文件并重命名为 '.env'
```
cp .env.example .env
```
- 编辑 '.env' 文件，填入您的 Google Ads API 凭据。您需要以下凭据：
  - 'GOOGLE_ADS_DEVELOPER_TOKEN'
  - 'GOOGLE_ADS_CLIENT_ID'
  - 'GOOGLE_ADS_CLIENT_SECRET'
  - 'GOOGLE_ADS_REFRESH_TOKEN'
  - 'GOOGLE_ADS_LOGIN_CUSTOMER_ID' (您的 MCC 账户 ID)
  - 'GOOGLE_ADS_CLIENT_CUSTOMER_ID' (可选，如果您想指定默认查询的客户账户)
  请务必妥善保管您的 API 凭据，避免泄露。
运行服务器
```
python server.py
```
服务器默认在 'http://localhost:8000' 启动。

服务器配置 (Claude Desktop)

要将此 MCP 服务器集成到 Claude Desktop 中，您需要在 Claude Desktop 应用的配置中添加以下 JSON 配置。请注意，您需要将 '/absolute/path/to/server.py' 替换为 'server.py' 文件在您本地文件系统中的绝对路径。

{
    "mcpServers": {
        "google-ads": {
            "command": "python",
            "args": [
                "/absolute/path/to/server.py"  // 替换为 server.py 的绝对路径，例如 "/Users/yourname/google-ads-mcp-server/server.py"
            ]
        }
    }
}

配置参数说明:

'server name': 'google-ads' (服务器名称，在Claude客户端中用于标识和选择此服务器)
'command': 'python' (启动服务器的命令，这里使用 python 解释器)
'args': '["/absolute/path/to/server.py"]' (传递给启动命令的参数，即 server.py 脚本的绝对路径)

配置完成后，重启 Claude Desktop 应用，您应该能在 Claude 界面中看到工具图标，表示 MCP 服务器已成功集成。

基本使用方法

在 Claude 中，您可以像与 Claude Bot 对话一样，自然语言提问关于 Google Ads 数据的问题，例如：

"Show me my Google Ads account performance" (展示我的 Google Ads 账户效果)
"What campaigns are performing well in my account?" (哪些广告系列在我的账户中表现良好？)
"Create a visualization of my campaign performance" (创建我的广告系列效果的可视化图表)

Claude 将调用 Google Ads MCP Server 提供的工具，获取数据并返回结果，或者生成可视化图表在 Claude Artifacts 中展示。

关键词