facebook-ads-mcp-server 由 gomarble-ai 开发,是一个 MCP(Model Context Protocol)服务器,作为访问 Meta Ads(Facebook 广告)的接口,提供对 Meta 广告数据和管理功能的编程式访问。
主要用途:让兼容 MCP 的 AI 客户端(例如 Cursor、Claude Desktop)能够通过该服务器读取和管理 Meta Ads 对象与数据。
主要能力:作为 MCP 服务器提供与 Meta Ads 对象和数据交互的工具;多数工具支持 fields、filtering、limit、分页、日期范围等附加参数,完整的参数列表与说明记录在 server.py 的文档字符串中。
使用方式:项目提供一键安装器(下载地址 https://gomarble.ai/mcp),可在本地安装并配置 MCP 服务器、自动处理环境设置,并在过程中提示 Meta 令牌认证(可选)。若未提供 Meta 访问令牌,则连接 GoMarble 的服务器代为创建令牌;GoMarble 不存储令牌,令牌保存在本地机器上供 MCP 服务器使用。也可手动安装:可选但推荐创建并激活 Python 虚拟环境(python3 -m venv venv;source venv/bin/activate,Windows 使用 venv\Scripts\activate),然后执行 pip install -r requirements.txt 安装依赖;再获取具有 ads_read 等必要权限的 Meta 用户访问令牌(可通过 Meta 开发者门户生成)。与 MCP 客户端集成时,添加相应配置并替换 YOUR_META_ACCESS_TOKEN 为实际令牌、按需调整 server.py 路径,修改配置后重启 MCP 客户端应用(Windows 上可能需要调整命令结构或使用 cmd /k)。调试时可运行 server.py 并通过 --fb-token 参数提供访问令牌。此外,还可通过 Smithery 为 Claude Desktop 安装 Facebook Ads Server。项目提供 Slack 社区(AI in Ads)用于获取帮助和更新,并另有 Google Ads MCP 服务器可供使用。
适用场景:需要通过 AI 客户端以编程方式访问、查询或管理 Meta 广告数据的场景。
限制与注意事项:需要 Meta 访问令牌并具备相应权限;若令牌过期,需生成新令牌并更新 MCP 客户端的配置文件才能继续使用工具。项目依赖 requests(>=2.32.3),采用 MIT 许可证。其他信息暂未提供。