Facebook 广告 MCP 服务器

该项目提供了一个 MCP 服务器作为 Facebook 广告的接口，支持以编程方式访问 Facebook 广告数据和管理功能。

您的浏览器不支持视频标签。

轻松一键设置

为了获得更简单的安装体验，我们提供了即用型安装程序：

⊞ Windows： 👉 下载 gomarble_mcp_tools.exe
 MacOS: 👉 下载 gomarble_mcp_tools.pkg

它的作用

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

重要免责声明

此设置不需要您手动获取 Facebook 开发人员访问令牌。

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

设置

先决条件

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

（可选但推荐）创建并激活虚拟环境：
python3 -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
使用虚拟环境有助于干净地管理项目依赖关系[来源] 。
安装依赖项：
pip install -r requirements.txt
**获取 Facebook 访问令牌：**获取一个具有必要权限（例如ads_read ）的 Facebook 用户访问令牌。您可以通过 Facebook 开发者平台生成此令牌。请点击此链接。

与 MCP 客户端一起使用（例如 Cursor、Claude Desktop）

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

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_FACEBOOK_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_FACEBOOK_ACCESS_TOKEN"
      // ]
    }
  }
}

更新配置后重新启动 MCP 客户端应用程序。

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

调试服务器

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

python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN

可用的 MCP 工具

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

工具名称	描述
帐户和对象读取
`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中的详细文档字符串，了解每个工具的参数的完整列表和说明。）

（注意：如果您的 Facebook 访问令牌已过期，您需要生成一个新的令牌并使用新令牌更新 MCP 客户端的配置文件才能继续使用这些工具。）

依赖项

mcp （>=1.6.0）
请求（>=2.32.3）

执照

该项目已获得 MIT 许可。

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Facebook 广告服务器：

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

Facebook-Ads-MCP-Server