Skip to main content
Glama

Facebook-Ads-MCP-Server

by gomarble-ai

Facebook 广告 MCP 服务器

铁匠徽章

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

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

轻松一键设置

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

它的作用

  • 在本地安装并配置 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 用户访问令牌。您可以通过 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 上,您可能需要根据您的设置调整命令结构或使用

调试服务器

执行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

检索广告组的变更历史记录。

(注意:大多数工具支持附加参数,如

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

依赖项

执照

该项目已获得 MIT 许可。


通过 Smithery 安装

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

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude
-
security - not tested
A
license - permissive license
-
quality - not tested

Related MCP Servers

  • -
    security
    A
    license
    -
    quality
    MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
    Last updated -
    2
    3
    MIT License
  • -
    security
    F
    license
    -
    quality
    An MCP server that enables interaction with Google's Display & Video 360 advertising platform API, allowing management of digital advertising campaigns through natural language commands.
    Last updated -
    • Linux
    • Apple

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gomarble-ai/facebook-ads-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server