内容
# 广告 MCP 服务器
[](https://crates.io/crates/mcp-ads)
[](LICENSE)
[](https://enterprise.adk-rust.com)
[](https://www.zavora.ai)
适用于 [ADK-Rust 企业版](https://enterprise.adk-rust.com) 销售和营销代理的数字广告平台。19 个 MCP 工具涵盖了活动、广告组、广告/创意、**预算和出价**、受众、每日绩效指标与 **衍生 KPI（CTR/CPC/CPA/CVR/ROAS）**、预算节奏控制和 **优化建议** — 通过审计追踪，并对每个影响支出的变更设置审批门槛。
## 平台而非点解决方案
该平台被设计为一个通用的广告管理骨架（类似于 Google Ads / Meta Ads Manager），因此营销代理是共享系统的客户端：
| 代理 | 域名 | 用途 |
|-------|--------|------|
| **活动优化器** | 销售-营销 | `campaign_performance`、`budget_pacing`、`optimize`，然后是受控的 `set_bid` / `set_budget` / `set_campaign_status` |
优化器 **读取** 性能并 **建议** 操作；移动资金的操作（出价、预算、状态）是独立的、需要审批的工具 — 因此分析是自由流动的，而支出仍然受到控制。
## 架构
<p align="center">
<img src="https://raw.githubusercontent.com/zavora-ai/mcp-ads/main/docs/architecture.svg" alt="广告 MCP 架构" width="780"/>
</p>
## 功能
- **活动层次结构** — 活动（目标、渠道、每日预算）→ 广告组（出价策略 + 出价/目标、受众）→ 广告/创意。
- **受众** — 兴趣 / 再营销 / 相似人群 / 自定义受众，附带预估规模。
- **指标和 KPI** — 每天导入展示次数/点击次数/花费/转化次数/收入；在广告组和汇总的活动级别计算出 **CTR、CPC、CPA、CVR、ROAS**。
- **预算节奏控制** — 今日花费 vs. 每日预算，附带节奏控制标志（支出不足 / 按计划进行 / 支出过快 / 预算耗尽）。
- **优化** — 基于规则的建议，针对每个广告组：扩大高 ROAS 的赢家、削减/暂停低于收支平衡或零转化组的支出、标记低 CTR，并捕捉 CPA 超过目标 CPA 策略的目标。
## 治理立场
- **三个直接影响支出的写入操作受到管控**（`requires_approval`、`external_write`）：`set_budget`、`set_bid` 和 `set_campaign_status`（暂停/激活活动会改变其支出状态）。创建实体和导入指标是正常的内部写入操作。
- **`optimize` 是只读的** — 它提供建议；应用建议需要经过受控的工具。预算和出价保证非负；已结束的活动是终端状态。
- 所有重要信息都记录在审计追踪中（`audit_log`）。示例数据是虚构的。
## 工具（19）
### 活动（5）
`create_campaign` · `get_campaign` · `list_campaigns` · `set_campaign_status`（受控）· `set_budget`（受控）
### 广告组和广告（6）
`create_ad_group` · `get_ad_group` · `list_ad_groups` · `set_bid`（受控）· `create_ad` · `list_ads`
### 受众和指标（3）
`create_audience` · `list_audiences` · `ingest_metrics`
### 绩效和优化（5）
`ad_group_performance` · `campaign_performance` · `budget_pacing` · `optimize` · `audit_log`
## 示例
```jsonc
// 活动优化器：读取性能，获取建议，然后采取行动（受控）
{"name": "campaign_performance", "arguments": {"campaign_id": "CMP-1002"}}
{"name": "optimize", "arguments": {"campaign_id": "CMP-1002"}}
{"name": "set_bid", "arguments": {"ad_group_id": "ADG-1003", "bid": 5.0}}
{"name": "set_budget", "arguments": {"campaign_id": "CMP-1002", "daily_budget": 800}}
```
## 安装和运行
```bash
cargo install mcp-ads
mcp-ads # 通过标准输入输出提供 MCP 服务
```
或从源代码构建：
```bash
git clone https://github.com/zavora-ai/mcp-ads
cd mcp-ads && cargo build --release
./target/release/mcp-ads
```
## 注册表清单
```toml
server_id = "mcp_ads"
display_name = "广告 / 广告"
version = "1.0.0"
domain = "sales-marketing"
risk_level = "high"
writes_allowed = "gated"
```
完整的 [`mcp-server.toml`](mcp-server.toml) 声明了所有 19 个工具及其风险类别和注册表上线所需的审批门槛。
## 许可证
Apache-2.0
