Facebook Ads MCP Server

Facebook/Meta 广告 MCP 服务

此项目提供了一个 MCP 服务，作为 Meta Ads 的接口，可通过编程方式访问 Meta Ads 数据和管理功能。

您的浏览器不支持 video 标签。

轻松一键设置

为了让设置更简单，我们提供了可直接使用的安装程序：

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

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

👉 Slack 社区 - AI in Ads

也可以试试 Google Ads 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 Developer 门户生成令牌。请参阅此链接。

与 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"
      ]
      // If using a virtual environment, you might need to specify the python executable within the venv:
      // "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。）

调试服务

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

python server.py --fb-token YOUR_META_ACCESS_TOKEN

可用的 MCP 工具

此 MCP 服务提供用于与 META Ads 对象和数据交互的工具：

工具名称	描述
账户与对象读取
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	根据 ID 获取多个广告组的详细信息。
获取集合
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 自动为 Claude Desktop 安装 Facebook Ads Server：

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