Facebook广告MCP服务器
](https://smithery.ai/server/@gomarble-ai/facebook-ads-mcp-server)
该项目提供了一个MCP服务器，作为Facebook广告的接口，实现了对Facebook广告数据和管理功能的程序化访问。
您的浏览器不支持视频标签。
轻松一键设置
为了获得更简单的安装体验，我们提供即用型安装程序：
👉 下载安装程序- https://gomarble.ai/mcp
加入我们的社区以获取帮助和更新
👉 Slack社区- 广告中的人工智能
也试试谷歌广告mcp服务器
👉 谷歌广告MCP- 谷歌广告MCP
它做什么
- 在本地安装和配置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`使用虚拟环境有助于清晰地管理项目依赖关系[\[来源\]](https://docs.python.org/3/tutorial/venv.html).
- 安装依赖关系：
pip install -r requirements.txt- 获取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