AdOps MCP

基于 AI 的模型上下文协议 (MCP) 跨平台广告管理工具

License: MIT TypeScript MCP

通过 Claude、Cursor 和 VS Code 等 AI 助手，管理 Google Ads 和 Meta Ads 广告系列、分析跨平台表现、优化预算并检测异常。

功能特性

Google Ads 和 Meta Ads 的统一广告系列管理
14 个涵盖完整广告生命周期的 MCP 工具
4 个用于快速访问仪表板的 MCP 资源
具有标准化指标的跨平台表现报告
基于 AI 的预算优化及可执行建议
统计学异常检测（CPC 激增、CTR 下降、支出激增）
带有置信度评分的 A/B 测试分析
行业基准对比（9 个垂直领域）
支出和转化预测（7/14/30 天）
平台特定的创意规格参考
42 项自动化测试（单元测试 + E2E 用户工作流）、TypeScript 严格模式、Zod 验证

快速开始

从 npm 安装

npm i adops-mcp-server

添加到您的 MCP 客户端

{
  "mcpServers": {
    "adops": {
      "command": "node",
      "args": ["path/to/node_modules/adops-mcp-server/dist/index.js"]
    }
  }
}

从源码构建

git clone https://github.com/enzoemir1/adops-mcp.git
cd adops-mcp
npm ci && npm run build

工具

工具	描述
`platform_connect`	注册 Google Ads 或 Meta Ads 账户连接
`campaign_list`	列出并筛选所有已连接平台上的广告系列
`campaign_create`	使用统一参数创建新广告系列
`campaign_update`	更新广告系列设置（预算、状态、出价、排期）
`campaign_pause_resume`	批量暂停或恢复最多 50 个广告系列
`ads_report`	生成统一的跨平台表现报告
`budget_analyze`	分析预算分配并提供优化建议
`budget_reallocate`	在不同平台的广告系列之间转移预算
`audience_insights`	获取人口统计、地理位置和设备细分数据
`creative_specs`	获取特定平台的图片、视频和文本要求
`anomaly_detect`	以可配置的灵敏度检测表现异常
`ab_test_analyze`	通过统计显著性测试比较两个广告系列
`competitor_benchmark`	将您的指标与行业平均水平进行比较
`forecast_spend`	预测下一周期的支出、转化和 ROAS

资源

资源	描述
`ads://overview`	跨平台仪表板摘要
`ads://campaigns`	所有带有关键指标的活跃广告系列
`ads://budget`	跨平台的预算分配情况
`ads://alerts`	近期的表现异常和警告

配置

所有集成均为可选。该服务器无需 API 密钥即可运行，使用本地存储进行广告系列管理和分析。

变量	平台	必需	描述
`GOOGLE_ADS_DEVELOPER_TOKEN`	Google	实时同步需	API 开发者令牌
`GOOGLE_ADS_CLIENT_ID`	Google	实时同步需	OAuth2 客户端 ID
`GOOGLE_ADS_CLIENT_SECRET`	Google	实时同步需	OAuth2 客户端密钥
`GOOGLE_ADS_REFRESH_TOKEN`	Google	实时同步需	OAuth2 刷新令牌
`GOOGLE_ADS_CUSTOMER_ID`	Google	实时同步需	广告账户 ID（10 位数字）
`META_APP_ID`	Meta	实时同步需	Facebook 应用 ID
`META_APP_SECRET`	Meta	实时同步需	Facebook 应用密钥
`META_ACCESS_TOKEN`	Meta	实时同步需	系统用户访问令牌
`META_AD_ACCOUNT_ID`	Meta	实时同步需	广告账户 ID (act_XXX)

请参阅 .env.example 获取完整模板。

统一指标

AdOps 将各平台的指标标准化为单一模式：

指标	公式	描述
CTR	点击量 / 展示量 x 100	点击率 (%)
CPC	支出 / 点击量	单次点击成本
CPM	支出 / 展示量 x 1000	每千次展示成本
ROAS	收入 / 支出	广告支出回报率
CPA	支出 / 转化量	单次获取成本
转化率	转化量 / 点击量 x 100	转化率 (%)

平台字段映射：

AdOps 字段	Google Ads	Meta Ads
`spend`	`cost_micros / 1,000,000`	`amount_spent`
`impressions`	`impressions`	`impressions`
`clicks`	`clicks`	`clicks`
`conversions`	`conversions`	`actions[type=purchase]`
Campaign > Ad Group	Ad Group	Ad Set

定价

层级	价格	功能
免费版	$0	1 个平台，只读报告，创意规格，50 次调用/天
专业版	$29/月	2 个平台，完整 CRUD，异常检测，预算优化
代理版	$59/月	无限制，预测，基准测试，优先支持

可在 MCPize 上获取。

开发

npm run dev        # Hot reload development
npm run build      # Production build
npm test           # Run 42 tests (unit + E2E)
npm run inspect    # Open MCP Inspector

测试

涵盖 5 个测试套件的 42 项测试：

存储: 连接 CRUD、广告系列搜索、指标聚合、批量插入
分析: 指标计算、表现报告、预测、基准测试
优化器: 预算分析、重新分配、扩容/暂停建议
异常: CPC 激增检测、转化下降、灵敏度级别、严重程度排序
E2E 工作流: 14 个真实用户场景 — 连接平台、创建广告系列、生成报告、优化预算、运行 A/B 测试、检测异常、预测支出、行业基准对比

npm test

许可证

MIT 许可证。详情请参阅 LICENSE。

由 Automatia BCN 构建。

adops-mcp