项目简介
这是一个基于 Model Context Protocol (MCP) 的服务器实现,专门用于管理和自动化 Facebook Page 的互动。它将 Facebook Graph API 的常见操作(如创建帖子、回复评论、获取数据分析等)封装成一系列可供大型语言模型 (LLM) 客户端调用的标准化工具。
主要功能点
该服务器提供以下核心功能,通过AI调用实现对Facebook Page的管理:
- 发布内容: 创建新的 Facebook 页面帖子。
- 评论管理: 回复、删除帖子或评论。
- 数据获取: 获取页面最新帖子、帖子评论、帖子点赞数、评论数等。
- 数据分析: 获取帖子印象数(总数、唯一、付费、自然)、参与用户数、点击数以及各种心情反应(赞、爱、惊讶、哈哈、伤心、愤怒)的总数。
- 自动化过滤: 提供一个基础工具,根据关键词过滤负面评论。
这些功能使得社交媒体经理可以通过自然语言指令,借助LLM自动完成页面日常运营和分析工作。
安装步骤
-
克隆仓库: 打开终端,执行命令下载项目代码:
git clone https://github.com/HagaiHen/facebook-mcp-server.git cd facebook-mcp-server -
安装依赖: 该项目使用 uv 作为包管理器(如果未安装 uv,请先按 README 中的指示安装)。 在项目目录下执行命令安装所需的 Python 库:
uv pip install -r requirements.txt -
配置环境: 在项目根目录创建名为 '.env' 的文件,并填入你的 Facebook Page 访问令牌和页面ID。你需要访问 Facebook 开发者工具获取这些信息。
FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token FACEBOOK_PAGE_ID=your_page_id
服务器配置 (供 MCP 客户端使用)
该 MCP 服务器被设计为通过 Stdio 协议运行,供本地的 MCP 客户端(如 Claude Desktop)调用。客户端需要配置此服务器的启动命令及其参数。通常,您需要在 MCP 客户端的配置界面中添加一个条目,指定服务器的名称、启动命令和参数。
配置信息通常包含以下部分(具体格式取决于您的 MCP 客户端):
- 'name': 您为此服务器连接指定的名称,例如 "FacebookMCP"。
- 'command': 执行服务器的命令。根据安装说明,这通常是 'uv'。
- 'args': 传递给 'command' 的参数列表。这包括运行环境 ('--with mcp[cli] --with requests')、MCP 运行指令 ('mcp run') 以及服务器脚本的完整路径(例如 '/path/to/facebook-mcp-server/server.py')。您需要将 '/path/to/facebook-mcp-server/' 替换为您实际克隆项目到的目录路径。
请参考您的 MCP 客户端文档,找到添加自定义服务器的选项,并填入相应信息。
基本使用方法
在 MCP 客户端中成功配置并连接此 Facebook MCP 服务器后,您可以通过与 LLM 的自然语言交互来调用服务器提供的工具。
例如,您可以尝试向 LLM 发出指令:
- “请帮我在 Facebook 页面发布一条消息:'今日份分享:晴空万里!'” (这将调用 'post_to_facebook' 工具)
- “获取我最新一条 Facebook 帖子的所有评论。” (这将调用 'get_page_posts' 和 'get_post_comments' 工具)
- “统计 ID 为 [帖子的实际ID] 的帖子有多少赞。” (这将调用 'get_number_of_likes' 工具)
LLM 会识别您的意图,并自动构建 JSON-RPC 请求发送给 Facebook MCP 服务器,服务器执行相应的 Facebook API 调用并将结果返回给 LLM,LLM 再将结果以友好的方式呈现给您。
信息
分类
通信与社交