内容
# Meta 广告 MCP 服务器
一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，向 Claude（桌面版或代码版）公开 Meta 广告数据。
## 工具列表
| 工具 | 描述 |
|---|---|
| `get_ad_accounts` | 列出所有可访问的广告账户 |
| `get_account_info` | 获取特定账户的详细信息 |
| `get_campaigns` | 列出广告活动，可选状态筛选 |
| `get_adsets` | 列出广告组 |
| `get_ads` | 列出单个广告 |
| `get_account_insights` | 账户级指标 |
| `get_campaign_insights` | 广告活动级指标，支持排序和细分 |
| `get_adset_insights` | 广告组级指标 |
| `get_ad_insights` | 广告级指标 |
| `get_insights_by_time` | 时间序列数据，用于趋势分析 |
## 要求
- Python 3.10+
- 一个 Meta [系统用户令牌](https://www.facebook.com/business/help/503306463479099)，需具备 `ads_read` 权限
## 设置
### 1. 克隆和安装
```bash
git clone https://github.com/your-user/meta-ads-mcp
cd meta-ads-mcp
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install -r requirements.txt
```
### 2. 配置凭证
```bash
cp .env.example .env
```
编辑 `.env` 并填写您的值：
```env
META_APP_ID="your_app_id"
META_APP_SECRET="your_app_secret"
META_GRAPH_VERSION="v21.0"
META_SYSTEM_USER_TOKEN="your_system_user_token"
```
### 3. 添加到 Claude 桌面版
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）或
`%APPDATA%\Claude\claude_desktop_config.json`（Windows）：
```json
{
"mcpServers": {
"meta-ads": {
"command": "/absolute/path/to/.venv/bin/python",
"args": ["/absolute/path/to/server.py"]
}
}
}
```
重启 Claude 桌面版。 🔨 图标将显示可用的工具。
### 4. 添加到 Claude 代码版
```bash
claude mcp add meta-ads /absolute/path/to/.venv/bin/python -- /absolute/path/to/server.py
```
## 使用示例
连接后，自然地询问 Claude：
- *"显示我所有的 Meta 广告账户"*
- *"我的活跃广告活动是什么？"*
- *"给我过去 7 天的广告活动指标"*
- *"显示按国家/地区划分的花费和 ROAS"*
- *"本月每日业绩趋势"*
## 获取系统用户令牌
1. 前往 [Meta 商业管理器](https://business.facebook.com)
2. 设置 → 用户 → **系统用户**
3. 创建或选择系统用户
4. 点击 **生成令牌** → 选择您的应用 → 启用 `ads_read`
5. 将令牌复制到您的 `.env`
## 许可证
MIT
