Google Ads MCP Server

官方

用于与 Google Ads API 交互的官方 MCP 服务器

分类: 其他第 101 / 230
Stars: ★ 1.0k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Python · Docker
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 2 天前
工具数: 3

56FMRS · C

这是 Google 官方维护的 MCP 服务器，用于与 Google Ads API 交互。它提供查询工具和元数据资源，支持多种认证方式，并可以部署在本地或云端。适合需要将 AI 助手集成到广告账户管理中的用户，但需要注意数据暴露权限和令牌管理。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

10/20

维护活跃度

12/20

文档质量

12/20

安装易用性

12/20

查看各项评分依据

可靠性 10/20: 证据显示项目有明确的工具定义（search, get_resource_metadata, list_accessible_customers），并要求各工具输出符合既定的响应格式（如SearchResponse、GetResourceMetadataResponse等），这表明工具契约是清晰的。但审查中未发现单元测试或CI配置文件来验证服务器实际启动、MCP握手或工具行为，且错误处理细节（如API错误如何映射为MCP错误）未在源码中看到。因此给予10分，反映了happy path可能合理，但缺乏可验证的执行证据和错误处理测试。
安全与权限 10/20: 未发现恶意代码或明显的凭据窃取迹象。开发令牌和OAuth凭据通过环境变量传入，没有硬编码密钥。数据访问需要用户授权，并明确了数据暴露的警告。但权限最小化（如是否仅请求必要的Google Ads scope）未在发放的静态源码中确认，且资源访问控制（如customer ID）依赖用户输入，未见到明确的确认机制。因此未触发红线，但权限细节和确认流程不够透明，给予10分。
维护活跃度 12/20: 仓库未归档，有835个星，开放issue数少（8个），表明活跃度。README提到使用pipx安装和GitHub issue tracker，但没有看到版本发布（release）的明确信息或依赖更新策略。license为Apache-2.0，清晰。由于缺乏版本管理证据和维护流程细节，给予12分。
文档质量 12/20: README涵盖了安装、认证（包括多重选项）、配置示例和部署指南，文档分层（本地、Cloud Run），并给出了示例提示。但工具参数的具体说明（如search的query格式、customer_id的必需性）和限制（如配额、成本）未详细说明，故障排查信息不足。因此给予12分。
安装易用性 12/20: 安装步骤清晰：需要Python、pipx、开发令牌、启用API、配置凭据，并提供了主流客户端的配置示例。但步骤较繁琐（多个前置条件），且依赖外部凭据和Google Cloud设置。未发现CI或测试来验证安装过程的可靠性。因此给予12分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

营销人员
数据分析师
使用 AI 助手管理 Google Ads 账户的开发者
需要自动化广告报告和分析的团队

不适合谁

没有 Google Ads 账户或没有有效开发者令牌的用户
无法访问生产账户的测试令牌用户
需要直接修改广告预算或出价的用户（服务器只提供查询和元数据功能）
完全离线的环境（需要访问 Google Ads API）

所需权限

需要 Google Ads API 的访问令牌，通常通过 OAuth 2.0 提供
需要开发者令牌，至少具有 Explorer 访问权限
需要 Google Cloud 项目中的 Google Ads API 已启用
凭据必须包含 adwords 作用域

风险与副作用

服务器会将您的广告数据暴露给连接的 AI 代理或 LLM
API 调用可能包含敏感的业务数据
如果密钥泄露，可能导致未经授权的访问
存在配额和速率限制，过度使用可能导致服务中断

安装接入

准备工作

运行环境：Python · Docker

GOOGLE_APPLICATION_CREDENTIALS 必填密钥应用默认凭证 JSON 文件路径，通过 gcloud auth application-default login 获取。

GOOGLE_PROJECT_ID 必填启用了 Google Ads API 的 Google Cloud 项目 ID。

GOOGLE_ADS_DEVELOPER_TOKEN 必填密钥 Google Ads API 开发者令牌，需至少 Explorer 访问级别才能查询正式账号。

GOOGLE_ADS_MCP_OAUTH_CLIENT_SECRET 可选密钥 FastMCP OAuth 代理使用的 OAuth 2.0 客户端密钥。

GOOGLE_ADS_MCP_JWT_SIGNING_KEY 可选密钥跨实例签署 FastMCP JWT 的密钥。

GOOGLE_ADS_MCP_STORAGE_ENCRYPTION_KEY 可选密钥已存 OAuth 令牌的加密密钥。

其他可选配置项（10 个）

GOOGLE_ADS_LOGIN_CUSTOMER_ID 可选通过经理账号访问客户时的经理客户 ID。

GOOGLE_CLOUD_PROJECT 可选建议添加的 Google Cloud 项目 ID。

GOOGLE_ADS_MCP_TOOLS_CONFIG 可选自定义 tools_config.yaml 的路径，用于启用/禁用工具。

GOOGLE_ADS_MCP_OAUTH_CLIENT_ID 可选 FastMCP OAuth 代理使用的 OAuth 2.0 客户端 ID。

GOOGLE_ADS_MCP_BASE_URL 可选服务器可访问的基础 URL（默认 http://localhost:8080）。

GOOGLE_ADS_MCP_STORAGE_TYPE 可选 OAuth 状态存储后端（filetree、redis 或 memory）。

GOOGLE_ADS_MCP_STORAGE_PATH 可选 filetree 持久化存储的目录路径。

GOOGLE_ADS_MCP_STORAGE_REDIS_URL 可选 redis 存储后端的 Redis URL。

GOOGLE_ADS_MCP_STORAGE_DISABLE_ENCRYPTION 可选设为 true 可禁用令牌加密。

FASTMCP_HOST 可选设为 0.0.0.0 以允许 FastMCP 接受所有 IP 的连接。

安装 pipx。
按照官方指南获取开发者令牌，并确保至少具有 Explorer 访问权限。
在 Google Cloud 项目中启用 Google Ads API。
配置凭据：可选择 FastMCP OAuth 代理、应用默认凭据或 Google Ads Python 客户端库。
在 MCP 客户端配置中添加服务器，设置环境变量如 GOOGLE_ADS_DEVELOPER_TOKEN 和凭据路径。
如果使用 OAuth 代理，设置相关环境变量并启动服务器作为独立进程。

.mcp.json

{
  "mcpServers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "google-ads-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add google-ads-mcp -e GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON -e GOOGLE_PROJECT_ID=YOUR_PROJECT_ID -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_DEVELOPER_TOKEN -- pipx run --spec git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动 MCP 客户端后应能看到 google-ads-mcp 服务器；询问“what customers do I have access to?”，如果 list_accessible_customers 工具返回了客户 ID，说明连接成功。

常见排障

检查开发者令牌是否具有生产账户访问权限，否则会报错
确认 Google Cloud 项目中已启用 Google Ads API
验证凭据文件路径正确且具有 adwords 作用域
对于 OAuth 代理，确保所有相关环境变量设置正确，并检查服务器日志
确认 MCP 客户端配置中的环境变量名称和值正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

这个 ads-mcp 服务器能做什么？
我可以访问哪些客户账号？
我有多少个正在投放的广告系列？
本周我的广告系列表现如何？

工具能力 3

search 只读

检索 Google Ads 账户的相关信息。

get_resource_metadata 只读

获取有关 Google Ads API 资源类型（例如 "campaign"）的元数据，以了解数据结构及可查询的字段。

list_accessible_customers 只读

返回调用认证用户可直接访问的客户 ID 列表。

使用场景

查询广告账户中的活动广告系列数量

获取广告系列效果数据

列出用户有权访问的所有客户账户

查看 Google Ads API 的资源结构和可用字段

支持客户端

Antigravity CLI

Antigravity Code Assist

Claude Code

Cursor

VS Code with Copilot

依据项目文档列出，未经本站实测。

详细介绍

Google Ads MCP Server 是一个官方服务器，提供工具和资源，让 AI 代理和 LLM 能够查询和操作 Google Ads 数据。它支持搜索广告账户信息、获取资源元数据、列出可访问的客户，并提供发现文档、指标、细分和发布说明等资源。该服务器支持多种认证方式，包括 FastMCP OAuth 代理、应用默认凭据或 Google Ads API Python 客户端库，并可通过本地 stdio 或远程流式 HTTP 传输运行。

Google Ads MCP Server

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

工具能力 3

使用场景

支持客户端

详细介绍

同类可选方案