Facebook MCP Server 使用说明

项目简介

Facebook MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现,旨在为 LLM 应用提供与 Facebook Page 交互的能力。通过此服务器,LLM 可以自动化执行 Facebook Page 的内容发布、评论管理和信息检索等任务,例如自动发布帖子、回复用户评论、监控负面舆情等。

主要功能点

  • 发布帖子:允许 LLM 自动发布消息到指定的 Facebook Page。
  • 评论互动:支持回复特定帖子的评论,增强与用户的互动。
  • 内容检索:可以获取 Facebook Page 的帖子列表以及帖子的评论内容。
  • 负面评论过滤:能够根据关键词过滤帖子中的负面评论,辅助舆情监控。
  • 内容管理:支持删除 Facebook Page 上的帖子和评论。

安装步骤

  1. 安装 Python 环境:确保你的计算机上已安装 Python 3.7 或更高版本,并配置好 pip 包管理器。
  2. 克隆仓库:使用 git 命令克隆 GitHub 仓库到本地:
    git clone https://github.com/tiroshanm/facebook-mcp-server.git
  3. 进入仓库目录
    cd facebook-mcp-server
  4. 安装依赖:使用 pip 安装项目依赖的 Python 包:
    pip install -r requirements.txt  # 如果仓库中包含 requirements.txt 文件
    或者 (如果 'requirements.txt' 不存在):
    pip install mcp python-dotenv requests
  5. 配置 Facebook 凭据
    • 在仓库根目录下创建 '.env' 文件。
    • 在 '.env' 文件中添加你的 Facebook Page Access Token 和 Page ID,替换 'YOUR_PAGE_ACCESS_TOKEN' 和 'YOUR_PAGE_ID' 为你的实际值:
      FACEBOOK_PAGE_ACCESS_TOKEN=YOUR_PAGE_ACCESS_TOKEN
      FACEBOOK_PAGE_ID=YOUR_PAGE_ID
    • 重要:请将 '.env' 文件添加到 '.gitignore' 文件中,避免泄露敏感信息。

服务器配置

要将 Facebook MCP Server 集成到 MCP 客户端(例如 Claude Desktop),你需要配置 MCP 服务器的连接信息。以下是配置示例,你需要根据你使用的 MCP 客户端进行相应配置。

Claude Desktop (uv 配置示例)

{
  "mcpServers": {
      "facebook": {
          "serverName": "facebook",
          "command": "uv",
          "args": [
              "run",
              "src/facebook_mcp_server/server.py" // MCP 服务器入口文件路径
          ],
          "directory": "/path/to/facebook-mcp-server" // 替换为你的 facebook-mcp-server 仓库本地路径
      }
  }
}

Claude Desktop (python 配置示例)

如果你没有安装 'uv',也可以使用 'python' 命令运行服务器:

{
  "mcpServers": {
      "facebook": {
          "serverName": "facebook",
          "command": "python",
          "args": [
              "-m",
              "src.facebook_mcp_server.server" // 使用模块方式运行 MCP 服务器
          ],
          "directory": "/path/to/facebook-mcp-server" // 替换为你的 facebook-mcp-server 仓库本地路径
      }
  }
}

配置说明

  • '"serverName"': MCP 服务器的名称,例如 "facebook",用于在客户端中标识和调用。
  • '"command"': 启动 MCP 服务器的命令,可以是 'uv' (需预先安装 uv) 或 'python'。
  • '"args"': 命令参数,指定如何运行服务器脚本。
    • 对于 'uv',使用 '["run", "src/facebook_mcp_server/server.py"]' 直接运行服务器脚本。
    • 对于 'python',使用 '["-m", "src.facebook_mcp_server.server"]' 以模块方式运行,确保 Python 能够找到 'src.facebook_mcp_server.server' 模块。
  • '"directory"': MCP 服务器的工作目录,通常设置为你的 'facebook-mcp-server' 仓库的根目录。请务必将其替换为你本地仓库的实际路径

基本使用方法

  1. 启动服务器:根据你的 MCP 客户端配置,启动 Facebook MCP Server。
  2. 连接客户端:在 MCP 客户端中配置并连接到名为 "facebook" 的 MCP 服务器。
  3. 调用工具:在客户端中使用自然语言或指令,指示 LLM 调用服务器提供的工具,例如:
    • "请使用 'post_to_facebook' 工具发布消息 'Hello Facebook!'"
    • "使用 'get_page_posts' 工具获取我的 Facebook Page 上的所有帖子"
    • "使用 'filter_negative_comments' 工具过滤帖子ID为 '12345' 的负面评论"

请参考 MCP 客户端的文档,了解如何配置和使用 MCP 服务器以及如何调用工具。

信息

分类

通信与社交