Facebook内容管理代理

一个基于OpenAI Agent SDK和UV包管理器的智能AI代理,用于连接Facebook MCP服务器并管理Facebook页面内容。

  • by hina-ali651
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hina-ali651/Facebook_mcp_agent

使用说明

🧠 Facebook MCP代理

使用 OpenAI代理SDK (兼容Gemini),由 UV包管理器.
此代理连接到 Facebook MCP服务器 它可以在您的Facebook页面上发布和管理内容。


🚀 项目概述

该项目包括:

  • mcp_server.py → MCP服务器文件(运行与Facebook相关的操作)
  • main_agent.py → 主AI代理文件(与MCP服务器交互)
  • .env → 存储您的API密钥和令牌

代理人使用 Google Gemini API 随着 OpenAI兼容端点,所以你可以像OpenAI模型一样运行它。


🧩 特性

✅ 在Facebook页面上发布消息
✅ 检索页面数据(姓名、ID和帖子)
✅ 通过OpenAI代理SDK使用Gemini API
✅ 异步+MCP服务器通信
✅ 使用UV进行本地开发(没有严重依赖性)


⚙️ 安装和设置

1.️⃣ 克隆存储库

git clone https://github.com/hina-ali651/Facebook_mcp_agent.git
cd Facebook_mcp_agent

2.️⃣ 使用UV安装依赖项

uv sync

3.️⃣ 创建.env文件

在项目文件夹中,添加环境变量:

GEMINI_API_KEY=your_gemini_api_key
FACEBOOK_PAGE_ACCESS_TOKEN=your_facebook_page_access_token
FACEBOOK_PAGE_ID=your_facebook_page_id

🧠 运行MCP服务器

运行您的Facebook MCP服务器:

uv run mcp_server.py

🤖 运行代理

运行主代理:

uv run main_agent.py

您将看到如下提示:

💬 Type your request (or 'quit' to exit)
>>> Post 'Hello World' on Facebook

然后,代理将调用您的MCP服务器发布帖子。

🧱 项目结构

Facebook_mcp_agent/
│
├── main_agent.py        # Agent logic (OpenAI SDK + Gemini)
├── mcp_server.py        # Facebook MCP Server logic
├── .env                 # Environment variables
├── README.md            # Project documentation
└── uv.lock / pyproject.toml  # UV dependency files

🔐 重要提示

脸书应用程序必须处于实时模式,才能让公众看到。

如果你在开发模式下进行测试,只有测试人员和开发人员可以看到这些帖子。

始终保持.env文件私有——永远不要将其推送到GitHub。

如果您的令牌过期,请从Meta for Developers重新生成它→ 工具→ 访问令牌调试器。

🧰 技术栈

组件 描述
python 核心编程语言
紫外线 轻量级Python包管理器
OpenAI代理SDK 构建多工具AI代理的框架
API双子星 通过OpenAI兼容接口使用的大型语言模型
Facebook图形API 用于发布、删除和读取页面数据

作者

希娜·艾哈迈德·阿里

📜 许可证

此项目根据MIT许可证获得许可,您可以负责任地自由使用、修改和共享。

⭐ 如果你喜欢这个项目,别忘了为repo加星! 🌟