内容
# MCP 营销套件
用于性能营销的 Model Context Protocol (MCP) 服务器的生产级集合。通过 Claude 以自然语言管理广告活动、分析流量、审核跟踪并报告性能。
由在 Google、Meta、Microsoft、LinkedIn 和 Reddit 上投放真实广告的从业者构建。
## 套件
| MCP 服务器 | 平台 | 工具 | ~上下文成本 | 安装 |
|------------|----------|-------|---------------|---------|
| [mcp-google-ads](https://github.com/mharnett/mcp-google-ads) | Google 广告 | 34 | ~14K tokens | `npm install mcp-google-ads` |
| [mcp-bing-ads](https://github.com/mharnett/mcp-bing-ads) | 微软广告 | 10 | ~4K tokens | `npm install mcp-bing-ads` |
| [mcp-linkedin-ads](https://github.com/mharnett/mcp-linkedin-ads) | LinkedIn 广告 | 7 | ~3K tokens | `npm install mcp-linkedin-ads` |
| [mcp-reddit-ads](https://github.com/mharnett/mcp-reddit-ads) | Reddit 广告 | 18 | ~7K tokens | `npm install mcp-reddit-ads` |
| [meta-ads-mcp](https://github.com/pipeboard-co/meta-ads-mcp) | Meta（Facebook/Instagram） | 28 | ~11K tokens | `pip install meta-ads-mcp` |
| [mcp-ga4](https://github.com/mharnett/mcp-ga4) | Google Analytics 4 | 9 | ~4K tokens | `npm install mcp-ga4` |
| [mcp-google-gsc](https://github.com/mharnett/mcp-search-console) | Google 搜索控制台 | 4 | ~2K tokens | `npm install mcp-google-gsc` |
| [mcp-gtm-ga4](https://github.com/mharnett/mcp-gtm-ga4) | Google Tag Manager + GA4 | 14 | ~6K tokens | `npm install mcp-gtm-ga4` |
**124 个工具**，涵盖 **8 个平台**。7 个 TypeScript 服务器在 npm 上，1 个 Python 服务器在 PyPI 上。
## 选择您需要的（上下文很重要）
**不要安装全部八个。** 每个 MCP 服务器的工具模式都加载到 Claude 的上下文窗口中进行每次对话。安装整个套件会增加 **~50K tokens 的开销**，在您输入第一个消息之前 - 约占 Claude Desktop 上 200K 上下文窗口的 25%，而 Claude Desktop 尚不支持延迟加载工具。
选择您实际使用的平台。该套件设计为可累加，而不是全部或一无所有。
### 推荐的配置文件
**仅 Google 实践者**（~24K tokens）
```
mcp-google-ads + mcp-ga4 + mcp-google-gsc
```
**跨渠道付费媒体经理**（~36K tokens）
```
mcp-google-ads + meta-ads-mcp + mcp-ga4 + mcp-google-gsc
```
**完整的代理栈 - 仅当您实际运行所有五个广告平台时**（~50K tokens）
```
所有八个服务器
```
### 上下文成本说明
- 估计值假设每个工具模式约 400 个 tokens（名称 + 描述 + 参数）。实际成本因工具复杂性而异。
- **Claude Code 用户**：工具模式按需通过工具搜索加载，始于 2025 年晚些时候，因此实际成本显著降低（每个服务器约 1K tokens，用于名称，完整模式按需获取）。上述数字是最坏的情况（Claude Desktop、OpenAI 客户端、Cursor 等）。
- **按项目禁用服务器**：使用项目范围的 `.mcp.json`（在您的仓库根目录）加载仅与该客户端或工作流相关的 MCP，而不是全局启用所有服务器。
## 您可以使用
**活动管理** - 在 Google、Meta、Microsoft、LinkedIn 和 Reddit 上创建、暂停、更新和监控活动，全部在一个对话中。
**性能分析** - 拉取花费、转化、每次获取成本、广告投资回报率和自定义细分。在不同平台之间进行比较，无需在不同界面之间切换。
**搜索词审核** - 查看搜索查询、添加否定关键词、暂停表现不佳的查询。适用于 Google Ads 和 Microsoft Advertising。
**受众定位** - 搜索兴趣、行为、人口统计和地理定位目标。在启动前估计受众规模。
**分析和跟踪** - 查询 GA4 报告（历史和实时），检查搜索控制台中的网址，审核 Google Tag Manager 的同意合规性。
**标签管理** - 列出、创建和更新 Google Tag Manager 标签。审核所有标签的同意设置。在发布前在沙盒中预览更改。
## 快速入门
### 先决条件
- Node.js 18+（适用于 TypeScript 服务器）
- Python 3.10+（仅适用于 meta-ads-mcp）
- 您要使用的每个平台的 API 凭证
### 安装单个服务器
每个服务器都是独立的。**仅安装您需要的服务器** - 请参阅上面的 [选择您需要的（上下文很重要）](#choose-what-you-need-context-matters)。
```bash
# 广告平台 - 选择您实际运行的平台
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
# 分析和跟踪 - 选择您实际使用的平台
npm install mcp-ga4
npm install mcp-google-gsc
npm install mcp-gtm-ga4
```
### 配置 Claude Code
将服务器添加到您的 `.mcp.json` 中：
```json
{
"mcpServers": {
"google-ads": {
"command": "npx",
"args": ["mcp-google-ads"],
"env": {
"GOOGLE_ADS_CLIENT_ID": "您的客户端 ID",
"GOOGLE_ADS_CLIENT_SECRET": "您的客户端密钥",
"GOOGLE_ADS_REFRESH_TOKEN": "您的刷新令牌",
"GOOGLE_ADS_DEVELOPER_TOKEN": "您的开发者令牌",
"GOOGLE_ADS_CUSTOMER_ID": "123-456-7890"
}
},
"ga4": {
"command": "npx",
"args": ["mcp-ga4"],
"env": {
"GA4_PROPERTY_ID": "您的属性 ID",
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json"
}
},
"meta-ads": {
"command": "meta-ads-mcp",
"env": {
"META_ACCESS_TOKEN": "您的访问令牌",
"META_APP_ID": "您的应用 ID"
}
}
}
}
```
**安全：** 永远不要分享您的 `.mcp.json` 文件或将其提交到 git - 它可能包含 API 凭证。将 `.mcp.json` 添加到您的 `.gitignore` 中。
查看每个服务器的 README 以获取完整的配置详细信息。
## 架构
所有 TypeScript 服务器共享一致的架构：
- **@modelcontextprotocol/sdk** 用于 MCP 协议处理
- **Cockatiel** 用于弹性（重试、指数退避、断路器、30 秒超时）
- **Pino** 用于结构化 JSON 日志记录
- **200KB 响应截断** 以防止上下文窗口溢出
- **错误分类** 为身份验证、速率限制和服务错误，并带有操作性消息
- **默认安全** - 写操作在激活前创建暂停状态下的项目
```
用户 <-> Claude <-> MCP 服务器 <-> 平台 API
|
弹性层
（重试、断路器、超时）
```
## 服务器详情
### 广告平台
**mcp-google-ads** - 最全面的服务器。34 个工具，包括 MCC（多客户端中心）支持、GAQL 查询、自动上下文检测（从工作目录）和完整的活动/关键词/广告管理。默认安全，具有审批工作流以激活。
**mcp-bing-ads** - 微软广告的 10 个工具。活动和关键词性能报告，带有来自 Bing ZIP 格式的 CSV 解析。共享否定关键词列表管理。
**mcp-linkedin-ads** - LinkedIn 活动管理器的 7 个工具。活动、广告组和创意管理，带有性能报告。
**mcp-reddit-ads** - Reddit 广告 API v3 的 18 个工具。活动、广告组和广告的完整 CRUD。子版块和兴趣定位。美元预算值（自动转换为微货币）。
**meta-ads-mcp** - Meta（Facebook/Instagram）广告的 28 个工具。由 Pipeboard 提供的第三方服务器。支持活动创建、受众定位、创意管理和性能洞察。
### 分析和跟踪
**mcp-ga4** - Google Analytics 4 的 9 个工具。历史报告、实时数据、自定义维度/指标管理。双配置模式：通过环境变量的单个属性或通过 config.json 的多客户端。
**mcp-google-gsc** - Google 搜索控制台的 4 个工具。搜索分析，带有维度过滤器（查询、页面、设备、国家）、网址检查以获取索引状态和站点列表。
**mcp-gtm-ga4** - 结合 Google Tag Manager 和 GA4 的 14 个工具。标签/触发器/变量管理、同意合规审核、工作区预览和版本控制。沙盒安全防止意外生产更改。
## 凭证指南
每个平台都需要其自己的 API 凭证。以下是获取凭证的位置：
| 平台 | 凭证类型 | 获取位置 |
|----------|----------------|-----------------|
| Google Ads | OAuth + 开发者令牌 | [Google Ads API 中心](https://ads.google.com/aw/apicenter) |
| 微软广告 | 通过 Azure AD 的 OAuth | [Azure 应用注册](https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade) |
| LinkedIn Ads | OAuth 应用 | [LinkedIn 开发者门户](https://www.linkedin.com/developers/apps) |
| Reddit Ads | OAuth 应用 | [reddit.com/prefs/apps](https://www.reddit.com/prefs/apps) |
| Meta Ads | 访问令牌 + 应用 ID | [Meta 开发者门户](https://developers.facebook.com/) |
| GA4 | 服务账户 | [Google Cloud 控制台](https://console.cloud.google.com/iam-admin/serviceaccounts) |
| 搜索控制台 | 服务账户 | 与 GA4 相同 |
| Google Tag Manager | 服务账户 | 与 GA4 相同 |
## 贡献
每个服务器都有自己的 GitHub 仓库。在那里提交问题和拉取请求：
- [mcp-google-ads](https://github.com/mharnett/mcp-google-ads/issues)
- [mcp-bing-ads](https://github.com/mharnett/mcp-bing-ads/issues)
- [mcp-linkedin-ads](https://github.com/mharnett/mcp-linkedin-ads/issues)
- [mcp-reddit-ads](https://github.com/mharnett/mcp-reddit-ads/issues)
- [mcp-ga4](https://github.com/mharnett/mcp-ga4/issues)
- [mcp-google-gsc](https://github.com/mharnett/mcp-search-console/issues)
- [mcp-gtm-ga4](https://github.com/mharnett/mcp-gtm-ga4/issues)
## 许可证
所有第一方服务器均使用 MIT 许可证。meta-ads-mcp 使用 BUSL-1.1（请参阅其仓库了解详情）。
## 作者
由 [Mark Harnett](https://github.com/mharnett) 在 [Drak Marketing](https://drakmarketing.com) 构建。这些工具每天用于管理多个客户端的真实广告支出。
