Facebook Ads MCP 服务器

用于在使用 Claude AI 的 Facebook 上提交和评估广告活动的 MCP（模型上下文协议）服务器。

描述

此 MCP 服务器提供了一个使用 MCP 协议与 Facebook Marketing API 通信的接口。它允许 Claude AI 和其他 LLM 模型处理 Facebook 广告——创建和管理广告活动、分析结果和优化效果。

功能

• 广告活动管理

  • 创建新的广告活动
  • 获取现有广告活动列表
  • 修改广告活动参数
  • 删除广告活动

• 分析和报告

  • 获取广告活动效果概览
  • 比较多个广告活动
  • 账户分析
  • 受众人口统计分析

• 受众管理

  • 创建自定义受众
  • 创建相似受众
  • 管理用户列表

• AI 助手

  • Claude AI 的提示模板
  • 广告活动效果分析
  • 优化建议

要求

• Node.js（版本 18 或更高版本）
• Facebook Business Manager 账户
• 具有 Marketing API 访问权限的 Facebook App
• 具有 Facebook Ads API 权限的访问令牌
• 支持 MCP 的 Claude AI 或其他 LLM

安装

1. 克隆存储库：

git clone https://github.com/Tisik79/MCP-Facebook.git
cd MCP-Facebook

2. 安装依赖项：

npm install

3. 创建一个包含以下内容的 .env 文件：

FACEBOOK_APP_ID=your_app_id
FACEBOOK_APP_SECRET=your_app_secret
FACEBOOK_ACCESS_TOKEN=your_access_token
FACEBOOK_ACCOUNT_ID=your_ad_account_id
PORT=3000

4. 编译 TypeScript：

npm run build

5. 启动服务器：

npm start

Claude Desktop 配置

要将此 MCP 服务器与 Claude Desktop 一起使用，请将以下配置添加到 Claude Desktop 配置文件：

{
  "mcpServers": {
    "facebook-ads": {
      "command": "node",
      "args": ["cesta/k/facebook-ads-mcp-server/dist/index.js"],
      "env": {
        "FACEBOOK_APP_ID": "<YOUR_APP_ID>",
        "FACEBOOK_APP_SECRET": "<YOUR_APP_SECRET>",
        "FACEBOOK_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "FACEBOOK_ACCOUNT_ID": "<YOUR_AD_ACCOUNT_ID>"
      }
    }
  }
}

可用工具

广告活动管理工具

• create_campaign - 创建新的广告活动
• get_campaigns - 获取广告活动列表
• get_campaign_details - 获取广告活动详情
• update_campaign - 更新广告活动
• delete_campaign - 删除广告活动

分析和评估工具

• get_campaign_insights - 获取广告活动分析数据
• get_account_insights - 获取账户汇总数据
• compare_campaigns - 比较多个广告活动
• get_campaign_demographics - 获取人口统计数据

受众管理工具

• create_custom_audience - 创建自定义受众
• get_custom_audiences - 获取受众列表
• create_lookalike_audience - 创建相似受众
• add_users_to_custom_audience - 将用户添加到受众

安全

此 MCP 服务器需要通过访问令牌访问您的 Facebook Business Manager 账户。确保此令牌安全存储，不要与未经授权的人员共享。

对于生产部署，我们建议：

• 使用具有最低必要权限的令牌
• 使用环境变量存储敏感数据
• 定期更新访问令牌
• 实施额外的安全层（防火墙、VPN）

许可证

根据 MIT 许可证分发。