Facebook MCP Server

Facebook MCP 服务

该项目是一个用于通过 Facebook Graph API 自动化管理 Facebook Page 互动的 MCP 服务。它提供创建帖子、审核评论、获取帖子数据洞察以及筛选负面反馈的工具，可直接接入 Claude 或其他基于大模型的 Agent。

---

🤖 这是什么？

此 MCP 提供一套可由 AI 调用的工具，可直接连接 Facebook Page，并将常见的 API 操作封装为便于大模型使用的函数。

✅ 优势

• 帮助社交媒体管理者自动化内容审核和数据分析。
• 与 Claude Desktop 或任何 Agent 客户端无缝集成。
• 通过自然语言精细控制 Facebook 内容。

---

📦 功能

工具	描述
post_to_facebook	使用消息创建一条新的 Facebook 帖子。
reply_to_comment	回复帖子中的特定评论。
get_page_posts	获取主页的最新帖子。
get_post_comments	获取指定帖子的评论。
delete_post	根据 ID 删除指定帖子。
delete_comment	根据 ID 删除指定评论。
hide_comment	隐藏评论，使其不对公众显示。
unhide_comment	取消隐藏之前隐藏的评论。
delete_comment_from_post	删除指定帖子中评论的别名。
filter_negative_comments	筛选包含负面情绪关键词的评论。
get_number_of_comments	统计帖子中的评论数量。
get_number_of_likes	统计帖子的点赞数量。
get_post_impressions	获取帖子的总展示次数。
get_post_impressions_unique	获取看到帖子的独立用户数量。
get_post_impressions_paid	获取帖子的付费展示次数。
get_post_impressions_organic	获取帖子的自然展示次数。
get_post_engaged_users	获取与帖子互动的用户数量。
get_post_clicks	获取帖子的点击次数。
get_post_reactions_like_total	获取“赞”反应的总数。
get_post_top_commenters	获取帖子中评论最多的用户。
post_image_to_facebook	向 Facebook 主页发布带说明文字的图片。
send_dm_to_user	向用户发送私信。
update_post	更新现有帖子的消息。
schedule_post	安排帖子在未来发布。
get_page_fan_count	获取主页粉丝总数。
get_post_share_count	获取帖子的分享次数。
get_post_reactions_breakdown	一次调用获取帖子的各类反应数量。
bulk_delete_comments	根据 ID 删除多条评论。
bulk_hide_comments	根据 ID 隐藏多条评论。
bulk_unhide_comments	根据 ID 取消隐藏多条评论。
get_comment_replies	获取对指定评论的所有回复。
get_post_permalink	获取帖子的固定链接 URL。
get_scheduled_posts	列出主页上所有已安排（尚未发布）的帖子。
get_page_info	获取主页的详细信息（名称、简介、类别、网站）。

---

🚀 设置与安装

1. 克隆仓库

git clone https://github.com/your-org/facebook-mcp-server.git
cd facebook-mcp-server

2. 🛠️ 安装

使用快速的 Python 包管理器 uv 安装依赖项： 如果尚未安装 uv，请运行：

curl -Ls https://astral.sh/uv/install.sh | bash

安装 uv 后，安装项目依赖项：

uv pip install -r requirements.txt

3. 设置环境

在根目录中创建一个 .env 文件，并添加 Facebook Page 凭据。 你可以从 https://developers.facebook.com/tools/explorer 获取这些凭据

FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token
FACEBOOK_PAGE_ID=your_page_id

🧩 与 Claude Desktop 配合使用

在 Clade 中设置 FacebookMCP：

1. 打开 Clade。
2. 前往 Settings → Developer → Edit Config。
3. 在打开的配置文件中，添加以下条目：

"FacebookMCP": {
  "command": "uv",
  "args": [
    "run",
    "--with",
    "mcp[cli]",
    "--with",
    "requests",
    "mcp",
    "run",
    "/path/to/facebook-mcp-server/server.py"
  ]
}

---

✅ 准备就绪！

就是这样——你的 Facebook MCP 服务现已完成配置，可以为 Claude Desktop 提供支持。现在，你可以通过自然语言提示词发布内容、进行审核并衡量互动效果！

---

🤝 贡献

欢迎提交贡献、问题和功能请求！
欢迎 Fork 此仓库并提交拉取请求。

• 创建分支：git checkout -b feature/YourFeature
• 提交更改：git commit -m 'feat: add new feature'
• 推送分支：git push origin feature/YourFeature
• 发起拉取请求 🎉