MCP Facebook广告管理服务

MCP服务器充当Facebook广告的接口，启用对Facebook广告数据和管理功能的程序化访问。

marketingsocial-media

402 查看 · 2026-07-07 更新

简介

MCP服务器充当Facebook广告的接口，启用对Facebook广告数据和管理功能的程序化访问。

简介

MCP服务器充当Facebook广告的接口，启用对Facebook广告数据和管理功能的程序化访问。

Facebook Ads 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  # 在Windows上使用 `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 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中的详细文档字符串以获取每个工具的完整参数列表及其描述。）

(注意：如果您的 Facebook 访问令牌过期，您需要生成一个新的令牌，并在 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

来源

来源：github
链接：https://github.com/gomarble-ai/facebook-ads-mcp-server