内容
# Google Ads MCP 服务器
Google Ads MCP 服务器是模型上下文协议（MCP）的实现，它使像Gemini这样的的大型语言模型（LLMs）能够直接与Google Ads API交互。
**这不是一个官方支持的Google产品。**
## 免责声明
版权所有 Google LLC。由Google LLC及其关联公司支持。本解决方案，包括任何相关的示例代码或数据，均按“原样”、“可用”和“带有所有故障”的基础上提供，仅用于说明目的，不提供任何形式的保证或陈述。本解决方案是实验性的、非支持的，仅为您的方便提供。您使用本解决方案受您与Google的适用协议的约束，并可能构成这些协议中定义的测试版功能。在您使用本解决方案时，您代表并保证您拥有所有必要的权利、同意和许可，以允许Google使用和处理您提供的数据。您使用本解决方案的任何部分，即表示您承认、假设和接受与使用本解决方案和Google处理数据相关的所有已知和未知的风险，包括与您在系统中的部署或与您的业务使用（如果有）相关的风险。关于向Google提供个人信息的授权，您将通过查看Google的隐私政策和其他公开信息来验证已建立的系统是足够的，并且您同意不会从Google获得进一步的信息。
## 入门指南
按照以下说明配置和运行Google Ads MCP服务器。
### 1. 配置Python环境
#### 直接使用
该项目需要Python 3.12和`pipx`。
#### 开发
该项目使用[`uv`](https://github.com/astral-sh/uv)进行依赖管理。
安装`uv`，然后运行以下命令安装所需的Python包：
```bash
uv pip sync
```
### 2. 配置Google Ads凭证
该工具要求您拥有包含Google Ads API凭证的`google-ads.yaml`文件。默认情况下，应用程序将在您的主目录中查找此文件。
如果您没有，可以通过运行`google-ads-python`库中的以下示例生成：[身份验证示例](https://github.com/googleads/google-ads-python/blob/main/examples/authentication/generate_user_credentials.py)
确保您的`google-ads.yaml`文件包含以下键：
- `client_id`
- `client_secret`
- `refresh_token`
- `developer_token`
- `login_customer_id`（可选，但推荐）
### 3. 启动MCP服务器
#### 使用Gemini CLI直接使用
更新您的Gemini配置以包含`google-ads-mcp`服务器。以下是一个本地MCP服务器配置示例：
```json5
{
// 其他配置...
"mcpServers": {
"GoogleAds": {
"command": "pipx",
"args": [
"run",
"--spec",
"git+https://github.com/googleanalytics/google-analytics-mcp.git",
"run-mcp-server"
],
"env": {
"GOOGLE_ADS_CREDENTIALS": "PATH_TO_YAML"
},
"timeout": 30000,
"trust": false
}
}
}
```
服务器启动后，您可以使用Gemini CLI与其交互。在Gemini中输入`/mcp`，即可在结果中看到列出的`Google Ads API`服务器。
#### 使用Gemini CLI进行本地开发
更新您的Gemini配置以包含`google-ads-mcp`服务器。 `[DIRECTORY]`将是项目的绝对路径。以下是一个本地MCP服务器配置示例：
```json5
{
// 其他配置...
"mcpServers": {
"GoogleAds": {
"command": "uv",
"args": [
"run",
"--directory",
"[DIRECTORY]",
"-m",
"ads_mcp.server"
],
"cwd": "[DIRECTORY]",
"timeout": 30000,
"trust": false
}
}
}
```
服务器启动后，您可以使用Gemini CLI与其交互。在Gemini中输入`/mcp`，即可在结果中看到列出的`Google Ads API`服务器。
您可以提出以下问题：
- “列出所有广告活动”
- “显示广告活动 `[CAMPAIGN_ID]` 的指标”
- “获取所有广告组”
#### 直接启动
要在项目路径中直接启动服务器，请运行以下命令：
```bash
uv run -m ads_mcp.server
```
服务器将启动并准备好接受请求。
## 贡献
我们欢迎贡献！请参阅我们的[贡献指南](CONTRIBUTING.md)了解详情。
## License
Google Ads MCP 服务器是一个开源项目，根据[APACHE-2.0 License](LICENSE)许可。
## 联系方式
如果您有任何问题、建议或反馈，请随时提出问题。
