营销协议服务器套件

一套用于性能营销的模型上下文协议(MCP)服务器套件,支持通过自然语言管理广告活动、分析流量、审核跟踪和报告性能。

  • by mharnett
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 mharnett/mcp-marketing-suite

使用说明

MCP营销套件

用于性能营销的模型上下文协议(MCP)服务器的生产级集合。管理广告活动、分析流量、审计跟踪和绩效报告——所有这些都可以通过克劳德的自然语言完成。

由在谷歌、Meta、微软、领英和Reddit上运行真实广告支出的从业者构建。

套房

MCP服务器 平台 工具 ~上下文成本 安装
mcp谷歌广告 谷歌广告 34 ~14K代币 npm install mcp-google-ads
mcp-bing广告 微软广告 10 ~4K代币 npm install mcp-bing-ads
mcp领英广告 领英广告 7 ~3K代币 npm install mcp-linkedin-ads
mcp reddit广告 Reddit广告 18 ~7K代币 npm install mcp-reddit-ads
元广告mcp Meta(脸书/Instagram) 28 ~11K代币 pip install meta-ads-mcp
mcp-ga4 谷歌分析4 9 ~4K代币 npm install mcp-ga4
mcp谷歌gsc 谷歌搜索控制台 4 ~2K代币 npm install mcp-google-gsc
mcp-gtm-ga4 谷歌标签管理器+GA4 14 ~6K代币 npm install mcp-gtm-ga4

124工具 跨越8个平台。npm上有7个TypeScript服务器,PyPI上有1个Python服务器。

选择您需要的内容(上下文很重要)

不要安装全部八个。 每次对话时,每个MCP服务器的工具模式都会加载到Claude的上下文窗口中。安装完整套件会增加 约50000个开销代币 在您键入单个消息之前——大约占Claude Desktop上200K上下文窗口的25%,该窗口尚不支持延迟工具加载。

选择你实际使用的平台。该套件的设计是附加的,而不是全部或全无。

推荐配置文件

仅限谷歌从业者 (约24K代币)

mcp-google-ads + mcp-ga4 + mcp-google-gsc

跨渠道付费媒体经理 (约36K代币)

mcp-google-ads + meta-ads-mcp + mcp-ga4 + mcp-google-gsc

完整的代理堆栈——只有当你真正运行所有五个广告平台时 (约5万个代币)

All eight servers

上下文成本说明

  • 估计假设每个工具模式(名称+描述+参数)约400个令牌。实际成本因工具复杂性而异。
  • Claude Code用户:从2025年底开始,工具模式通过工具搜索按需加载,因此实际成本显著降低(每台服务器的名称约为1K,根据需要获取完整模式)。上面的数字是最坏的情况(Claude Desktop、OpenAI客户端、Cursor等)。
  • 禁用每个项目的服务器:使用项目范围 .mcp.json (在您的repo根目录中)只加载与该客户端或工作流相关的MCP,而不是全局启用所有内容。

你能做什么

活动管理 --通过一次对话在谷歌、Meta、微软、领英和Reddit上创建、暂停、更新和监控活动。

性能分析 --拉动支出、转化率、CPA、ROAS和自定义细分。跨平台比较,无需在UI之间切换。

搜索词审计 --查看搜索查询,添加否定项,暂停表现不佳者。适用于谷歌广告和微软广告。

受众定位 --搜索兴趣、行为、人口统计和地理目标。在发布之前估计受众规模。

分析和跟踪 --查询GA4报告(历史和实时),检查Search Console中的URL,审核GTM同意合规性。

标签管理 --列出、创建和更新GTM标签。审核所有标签的同意设置。发布前预览沙盒中的更改。

快速开始

先决条件

  • Node.js 18+(用于TypeScript服务器)
  • Python 3.10+(仅适用于元广告mcp)
  • 要使用的每个平台的API凭据

安装单个服务器

每台服务器都是独立的。 只安装你需要的东西 --看 选择您需要的内容 上面。

# Ad platforms — pick what you actually run
npm install mcp-google-ads
npm install mcp-bing-ads
npm install mcp-linkedin-ads
npm install mcp-reddit-ads
pip install meta-ads-mcp

# Analytics & tracking — pick what you actually use
npm install mcp-ga4
npm install mcp-google-gsc
npm install mcp-gtm-ga4

配置Claude代码

将服务器添加到您的 .mcp.json:

{
  "mcpServers": {
    "google-ads": {
      "command": "npx",
      "args": ["mcp-google-ads"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "your-client-id",
        "GOOGLE_ADS_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_ADS_REFRESH_TOKEN": "your-refresh-token",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-dev-token",
        "GOOGLE_ADS_CUSTOMER_ID": "123-456-7890"
      }
    },
    "ga4": {
      "command": "npx",
      "args": ["mcp-ga4"],
      "env": {
        "GA4_PROPERTY_ID": "your-property-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json"
      }
    },
    "meta-ads": {
      "command": "meta-ads-mcp",
      "env": {
        "META_ACCESS_TOKEN": "your-access-token",
        "META_APP_ID": "your-app-id"
      }
    }
  }
}

安全: 永远不要分享你的 .mcp.json 文件或将其提交到git——它可能包含API凭据。添加 .mcp.json 到你的 .gitignore.

有关完整的配置详细信息,请参阅每台服务器的README。

建筑

所有TypeScript服务器共享一致的架构:

  • @模型上下文协议/sdk 用于MCP协议处理
  • 玄凤鹦鹉 弹性(指数回退重试,断路器,30秒超时)
  • 皮诺 用于结构化JSON日志记录
  • 200KB响应截断 防止上下文窗口溢出
  • 错误分类 转换为带有可操作消息的身份验证、速率限制和服务错误
  • 默认安全 --写操作创建处于PAUSED状态的项
User <-> Claude <-> MCP Server <-> Platform API
                        |
                   Resilience Layer
                   (retry, circuit breaker, timeout)

服务器详细信息

广告平台

mcp谷歌广告 --最全面的服务器。34种工具,包括MCC(多客户端中心)支持、GAQL查询、工作目录中的自动上下文检测以及完整的活动/关键字/广告管理。默认情况下是安全的,具有激活的审批工作流。

mcp-bing广告 --微软广告的10个工具。活动和关键字性能报告,从Bing的ZIP格式进行CSV解析。共享负面关键字列表管理。

mcp领英广告 --LinkedIn营销经理的7个工具。活动、广告组和创意管理以及绩效报告。

mcp reddit广告 --Reddit Ads API v3。针对广告系列、广告组和广告的完整CRUD。细分和兴趣定位。以美元为单位的预算值(自动转换为微货币)。

元广告mcp --28个Meta(脸书/Instagram)广告工具。Pipeboard的第三方服务器。支持活动创建、受众定位、创意管理和绩效洞察。

分析和跟踪

mcp-ga4 --谷歌分析的9个工具。历史报告、实时数据、自定义维度/度量管理。双配置模式:单属性通过env-vars或多客户端通过config.json。

mcp谷歌gsc --谷歌搜索控制台的4个工具。使用维度过滤器(查询、页面、设备、国家)、索引状态的URL检查和网站列表进行搜索分析。

mcp-gtm-ga4 --14个工具结合了谷歌标签管理器和GA4。标签/触发器/变量管理、同意合规性审计、工作区预览和版本控制。沙盒安全可防止意外的生产变更。

证书指南

每个平台都需要自己的API证书。以下是获取它们的地方:

平台 凭证类型 从哪里获取
谷歌广告 OAuth+开发者令牌 谷歌广告API中心
微软广告 通过Azure AD进行OAuth Azure应用程序注册
LinkedIn广告 OAuth应用程序 LinkedIn开发者门户
Reddit广告 OAuth应用程序 reddit.com/prefs/apps
元广告 访问令牌+应用ID 元开发者门户
GA4 服务帐户 谷歌云控制台
搜索控制台 服务帐户 与GA4相同
GTM 服务帐户 与GA4相同

贡献

每个服务器都有自己的GitHub存储库。文件问题和PR:

许可证

所有第一方服务器均获得麻省理工学院许可。meta ads mcp是BUSL-1.1(详见其仓库)。

作者

建造于 马克·哈内特 在 Drak营销这些工具每天用于管理多个客户的实际广告支出。