Google Ads MCP 服务器

更新于 2024 年 3 月 21 日 - 触发工作流运行

一个模型上下文协议 (MCP) 服务器，通过 Claude Desktop 提供对 Google Ads 数据的访问。

功能

• 通过 Claude 访问 Google Ads 广告系列、帐户和效果指标
• 支持管理 (MCC) 和客户帐户数据
• 内置缓存以提高性能并减少 API 调用
• Claude Artifacts 集成，用于数据可视化
• 多环境支持（开发、测试、生产）
• 使用 Docker 进行容器化部署

前提条件

• Python 3.9 或更高版本
• Google Ads API 凭据
• Claude Desktop

快速开始

本地开发

1. 克隆此存储库：

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

2. 设置虚拟环境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上，使用： .venv\Scripts\activate
   

3. 安装依赖项：

   pip install -r requirements.txt
   

4. 创建一个包含您的 Google Ads 凭据的 .env 文件：

   cp .env.example .env
   # 使用您的凭据编辑 .env 文件
   

5. 运行服务器：

   python server.py
   

Docker 部署

1. 构建 Docker 镜像：

   docker build -t google-ads-mcp:latest .
   

2. 运行容器：

   docker run -p 8000:8000 --env-file .env google-ads-mcp:latest
   

或者，使用 docker-compose：

docker-compose up -d

配置

该应用程序支持具有特定于环境的配置的不同环境（dev、test、prod）：

• 将 APP_ENV 设置为 dev、test 或 prod 以指定环境
• 按照 .env.example 中的说明配置环境变量
• 功能标志允许启用/禁用特定功能

Claude Desktop 集成

1. 在您的 Claude Desktop 应用程序配置中为 MCP 服务器配置 Claude Desktop：

   {
       "mcpServers": {
           "google-ads": {
               "command": "python",
               "args": [
                   "/absolute/path/to/server.py"
               ]
           }
       }
   }
   

2. 重新启动 Claude Desktop 并查找出现的工具图标

3. 通过提出以下问题，在 Claude 中使用 Google Ads 数据：

   • "向我展示我的 Google Ads 帐户效果"
   • "我的帐户中哪些广告系列表现良好？"
   • "创建我的广告系列效果的可视化"

部署

此存储库包含用于部署的 Kubernetes 清单：

• kubernetes/dev/ - 开发环境部署
• kubernetes/test/ - 测试环境部署
• kubernetes/prod/ - 生产环境部署

CI/CD 管道使用 GitHub Actions 配置，用于自动化测试、构建和部署。

安全

• 所有凭据都存储在 Kubernetes 密钥或环境变量中，而不是代码中
• 服务器使用适当的身份验证进行 API 访问
• 在生产环境中启用速率限制
• 遵循容器安全最佳实践

贡献

1. Fork 存储库
2. 创建一个功能分支：git checkout -b feature/my-feature
3. 提交您的更改：git commit -am 'Add new feature'
4. 推送到分支：git push origin feature/my-feature
5. 提交拉取请求

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• Google Ads API 团队提供的文档和支持
• Anthropic 提供的 Claude 和模型上下文协议