brianjking/google-ads-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

0 stars 7 forks 质量 54 趋势 0

Repository Install

Updated on May 22, 2025 - Phase 5 Automated Insights Features Implementation Complete

概览

Updated on May 22, 2025 - Phase 5 Automated Insights Features Implementation Complete A Model Context Protocol (MCP) server that provides access to Google Ads data through Claude Desktop. - Access Google Ads campaigns, accounts, and performance metrics via Claude - Budget Management API Endpoints with visualizations (Project Quantum Pulse Phase 3) - Keyword Management API Endpoints with visualizations (Project Quantum Pulse Phase 2) - Ad Group Management API Endpoints (Project Quantum Pulse Phase 1) - Support for both Manager (MCC) and client account data - Built-in caching to improve performance and reduce API calls - Claude Artifacts integration for data visualization - Multi-environment support (development, testing, production) - Containerized deployment with Docker This repository implements the Project Quantum Pulse roadmap for enhanced Google Ads management capabilities: - Get ad groups with filtering capabilities - View ad group performance metrics - Create new ad groups -...

README

以下为原文 README 节选，完整内容请查看原文。

Google Ads MCP Server

Updated on May 22, 2025 - Phase 5 Automated Insights Features Implementation Complete

A Model Context Protocol (MCP) server that provides access to Google Ads data through Claude Desktop.

Features

Access Google Ads campaigns, accounts, and performance metrics via Claude
Budget Management API Endpoints with visualizations (Project Quantum Pulse Phase 3)
Keyword Management API Endpoints with visualizations (Project Quantum Pulse Phase 2)
Ad Group Management API Endpoints (Project Quantum Pulse Phase 1)
Support for both Manager (MCC) and client account data
Built-in caching to improve performance and reduce API calls
Claude Artifacts integration for data visualization
Multi-environment support (development, testing, production)
Containerized deployment with Docker

Project Quantum Pulse Roadmap

This repository implements the Project Quantum Pulse roadmap for enhanced Google Ads management capabilities:

Phase 1: Ad Group Management API Endpoints (COMPLETE) - March 29 to April 4, 2025

Get ad groups with filtering capabilities
View ad group performance metrics
Create new ad groups
Update existing ad groups
Visualize ad group performance

Phase 2: Keyword Management API Endpoints (COMPLETE) - April 5 to April 18, 2025

Browse keywords with filtering capabilities ✅
Analyze search terms and find insights ✅
Add, update, and remove keywords ✅
Visualize keyword performance with tables, charts, and word clouds ✅

Phase 3: Budget Management API Endpoints (COMPLETE) - April 19 to May 2, 2025

Retrieve campaign budgets with performance metrics ✅
Analyze budget utilization and distribution ✅
Generate budget recommendations ✅
Visualize budget performance with charts and tables ✅
Update budget properties (API call implementation pending)

Phase 4: Enhanced Visualization Templates (COMPLETE) - May 3 to May 16, 2025

Implement comprehensive dashboard templates ✅
Create comparison visualization templates ✅
Build breakdown visualization templates ✅
Integration, testing, and documentation ✅

Phase 5: Automated Insights Features (COMPLETE) - May 17 to May 30, 2025

Implement performance anomaly detection ✅
Generate optimization suggestions ✅
Discover growth opportunities ✅
Create integrated insights dashboard ✅

Prerequisites

Python 3.9 or higher
Google Ads API credentials
Claude Desktop

Quick Start

Local Development

Clone this repository:

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

Set up a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

Install dependencies:
```
pip install -r requirements.txt
```

Create a .env file with your Google Ads credentials:

cp .env.example .env
# Edit .env file with your credentials

Run the server:
```
python server.py
```

在 GitHub 查看完整 README

安装

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

新手？先看 mcpskill.org 教程 →

配置

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