项目简介

本项目 Facebook Ads MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为 LLM 客户端提供访问 Facebook 广告平台数据的能力。通过此服务器，用户可以使用自然语言指令，借助 LLM 客户端，便捷地查询和分析 Facebook 广告数据，无需深入了解 Facebook Ads API 的细节。

主要功能点

提供多种工具，用于获取 Facebook 广告账户、广告系列、广告组、广告以及广告创意的详细信息。
支持丰富的洞察数据查询功能，可以获取广告账户、广告系列、广告组和广告的性能指标，例如展示次数、点击次数、花费等。
支持按时间范围、维度细分、过滤器等多种条件查询洞察数据。
支持分页功能，可以处理大量数据返回。
提供活动历史记录查询功能，可以追踪广告账户和广告组的变更历史。

安装步骤

确保已安装 Python 3.10 或更高版本。

(推荐) 创建并激活虚拟环境：

python3 -m venv venv
source venv/bin/activate

安装依赖：

pip install -r requirements.txt

获取 Facebook 访问令牌 (Access Token)：
- 访问 Facebook 开发者平台，创建一个应用。
- 获取用户访问令牌，并授予 'ads_read' 等必要的权限。

服务器配置

要将此服务器集成到 MCP 客户端（如 Cursor, Claude Desktop），您需要添加如下配置到客户端的配置文件中。请将 'YOUR_FACEBOOK_ACCESS_TOKEN' 替换为您实际的 Facebook 访问令牌，并将 '/path/to/your/fb-ads-mcp-server/server.py' 替换为 '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"
      ]
    }
  }
}

如果您使用了虚拟环境，可能需要指定虚拟环境中的 Python 可执行文件路径。配置完成后，重启 MCP 客户端应用。

基本使用方法

启动 MCP 服务器：在终端中，导航到 'server.py' 文件所在的目录，并运行以下命令，将 'YOUR_FACEBOOK_ACCESS_TOKEN' 替换为您的 Facebook 访问令牌：
```
python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN
```
在 MCP 客户端中，根据配置连接到 'fb-ads-mcp-server' 服务器。
使用自然语言指令，例如在 Cursor 中，您可以提问：
- "列出我的广告账户"
- "获取广告账户 act_123456789 的详细信息"
- "获取广告系列 23843xxxxx 的洞察数据，过去7天" 客户端会将指令转换为对 MCP 服务器的工具调用，并返回 Facebook 广告数据。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息