Facebook/Meta 广告 MCP 服务器

该项目提供了一个作为 Meta 广告接口的 MCP 服务器，使程序能够访问 Meta 广告数据和管理功能。

<video controls width="1920" height="512" src="https://github.com/user-attachments/assets/c4a76dcf-cf5d-4a1d-b976-08165e880fe4">您的浏览器不支持 video 标签。</video>

简单的一键设置

为了简化安装体验，我们提供了现成的安装程序：

👉 下载安装程序 - https://gomarble.ai/mcp

加入我们的社区获取帮助和更新

👉 Slack 社区 - AI in Ads

尝试 Google 广告 MCP 服务器

👉 Google Ads MCP - Google Ads MCP

功能介绍

• 在本地安装并配置 MCP 服务器
• 自动处理环境设置
• 在过程中提示进行 Meta 令牌认证（可选）
• 如果未提供 Meta 访问令牌，则连接到 GoMarble 的服务器为您创建令牌

重要免责声明

此设置不需要您手动获取 Meta 开发者访问令牌。

相反，它会安全地连接到GoMarble 的服务器为您创建令牌。 GoMarble不会存储您的令牌——它仅保存在您的机器上供 MCP 服务器使用。

---

安装

先决条件

• Python 3.10+
• requirements.txt 中列出的依赖项

1. （可选但推荐）创建并激活虚拟环境：

   python3 -m venv venv
   source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
   

   使用虚拟环境有助于干净地管理项目依赖项[来源]。

2. 安装依赖项：

   pip install -r requirements.txt
   

3. 获取 Meta 访问令牌： 获取具有必要权限（例如 ads_read）的 Meta 用户访问令牌。您可以通过 Meta 开发者门户生成此令牌。请参阅此链接。

与 MCP 客户端（如 Cursor、Claude Desktop）集成

要将此服务器与兼容 MCP 的客户端集成，请添加类似以下的配置（Claude）。用您的实际令牌替换 YOUR_META_ACCESS_TOKEN，并根据需要调整 server.py 的路径。

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_META_ACCESS_TOKEN"
      ]
      // 如果使用虚拟环境，您可能需要指定 venv 内的 python 可执行文件：
      // "command": "/path/to/your/fb-ads-mcp-server/venv/bin/python",
      // "args": [
      //   "/path/to/your/fb-ads-mcp-server/server.py",
      //   "--fb-token",
      //   "YOUR_META_ACCESS_TOKEN"
      // ]
    }
  }
}

在配置中进行更新后，请重新启动 MCP 客户端应用程序。

(注意：在 Windows 上，您可能需要根据您的设置调整命令结构或使用 cmd /k。)

调试服务器

通过 --fb-token 参数提供访问令牌来执行 server.py。

python server.py --fb-token YOUR_META_ACCESS_TOKEN

可用的 MCP 工具

此 MCP 服务器提供了与 Meta 广告对象和数据交互的工具：

工具名称	描述
账户及对象读取
list_ad_accounts	列出与令牌关联的广告账户。
get_details_of_ad_account	检索特定广告账户的详细信息。
get_campaign_by_id	检索特定活动的详细信息。
get_adset_by_id	检索特定广告集的详细信息。
get_ad_by_id	检索特定广告的详细信息。
get_ad_creative_by_id	检索特定广告创意的详细信息。
get_adsets_by_ids	检索多个广告集的详细信息。
收集数据
get_campaigns_by_adaccount	检索广告账户内的活动。
get_adsets_by_adaccount	检索广告账户内的广告集。
get_ads_by_adaccount	检索广告账户内的广告。
get_adsets_by_campaign	检索活动内的广告集。
get_ads_by_campaign	检索活动内的广告。
get_ads_by_adset	检索广告集内的广告。
get_ad_creatives_by_ad_id	检索与广告相关的创意。
洞察及性能数据
get_adaccount_insights	检索广告账户的性能洞察。
get_campaign_insights	检索活动的性能洞察。
get_adset_insights	检索广告集的性能洞察。
get_ad_insights	检索广告的性能洞察。
fetch_pagination_url	从分页 URL（例如来自洞察）中获取数据。
活动/变更历史
get_activities_by_adaccount	检索广告账户的变更历史。
get_activities_by_adset	检索广告集的变更历史。

(注意：大多数工具支持额外参数，如 fields、filtering、limit、分页、日期范围等。请参阅 server.py 中每个工具的完整参数列表和描述。)

(注意：如果您的 Meta 访问令牌过期，您需要生成新的令牌，并使用新令牌更新 MCP 客户端的配置文件以继续使用这些工具。)

依赖项

• mcp (>=1.6.0)
• requests (>=2.32.3)

许可证

本项目采用 MIT 许可证。

---

通过 Smithery 安装

要通过 Smithery 自动安装 Facebook Ads Server for Claude Desktop：

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude