Facebook/Meta Ads MCP服务器
 ](https://smithery.ai/server/@gomarble-ai/facebook-ads-mcp-server)
该项目提供了一个MCP服务器,作为Meta Ads的接口,实现了对Meta Ads数据和管理功能的程序化访问。
您的浏览器不支持视频标签。
轻松一键设置
为了获得更简单的安装体验,我们提供即用型安装程序:
👉 下载安装程序- https://gomarble.ai/mcp
加入我们的社区以获取帮助和更新
👉 Slack社区- 广告中的人工智能
也试试谷歌广告mcp服务器
👉 谷歌广告MCP- 谷歌广告MCP
它做什么
- 在本地安装和配置MCP服务器
- 自动处理环境设置
- 在过程中提示进行元令牌身份验证,这是可选的
- 如果未提供Meta访问令牌,请连接到GoMarble的服务器以代表您创建令牌
重要免责声明
此设置 不需要 您可以手动获取Meta Developer访问令牌。
相反,它安全地连接到 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- 获取元访问令牌: 使用必要的权限保护元用户访问令牌(例如。,
ads_read).您可以通过Meta Developer门户生成此内容。跟随 此链接.
使用MCP客户端(例如,Cursor、Claude Desktop)
要将此服务器与MCP兼容客户端集成,请添加配置(克劳德)与以下类似。替换 YOUR_META_ACCESS_TOKEN 使用您的实际令牌并调整路径 server.py 如有必要。
{
"mcpServers": {
"fb-ads-mcp-server": {
"command": "python",
"args": [
"/path/to/your/fb-ads-mcp-server/server.py",
"--fb-token",
"YOUR_META_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_META_ACCESS_TOKEN"
// ]
}
}
}在配置中进行更新后,重新启动MCP客户端应用程序。
*(注意:在Windows上,您可能需要调整命令结构或使用 cmd /k 这取决于您的设置。)*
调试服务器
执行 server.py,通过提供访问令牌 --fb-token 争论。
python server.py --fb-token YOUR_META_ACCESS_TOKEN可用的MCP工具
此MCP服务器提供与META-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 查看每个工具的参数的完整列表和描述。)*
*(注意:如果您的Meta访问令牌到期,您需要生成一个新的令牌,并使用新令牌更新MCP客户端的配置文件,以继续使用这些工具。)*
依赖项
许可证
该项目根据MIT许可证获得许可。
______________________________________________________________________
通过Smithery安装
通过以下方式自动安装Claude Desktop的Facebook广告服务器 史密瑟里:
npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude
