AI导哈

Facebook广告MCP服务器

提供Facebook广告数据的程序化访问和管理功能的MCP服务器接口。

  • by ChadRamsey-RamZHomeTeam
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 chadramsey-ramzhometeam/acebook-ads-mcp-server

使用说明

Facebook广告MCP服务器

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

轻松一键设置

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

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

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

👉 Slack社区- 广告中的人工智能

也试试谷歌广告mcp服务器

👉 谷歌广告MCP- 谷歌广告MCP

它做什么

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

重要免责声明

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

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

设置

先决条件

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

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

    python3 -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`

    使用虚拟环境有助于清晰地管理项目依赖关系[来源].

  2. 安装依赖关系：

    pip install -r requirements.txt

  3. 获取Facebook访问令牌： 使用必要的权限（例如。， ads_read).您可以通过Facebook开发者门户生成此内容。跟随 此链接.

使用MCP客户端（例如，Cursor、Claude Desktop）

要将此服务器与MCP兼容客户端集成，请添加配置(克劳德)与以下类似。替换 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客户端的配置文件，以继续使用这些工具。）

依赖项

许可证

该项目根据MIT许可证获得许可。

通过Smithery安装

通过以下方式自动安装Claude Desktop的Facebook广告服务器 史密瑟里:

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

相关 MCP