Skip to content

Facebook MCP server for automating posts, comment moderation, insights, and sentiment filtering.

Python

Create README.md

Hagai Henee54f5fcbdf7
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..80f811f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,114 @@
+# Facebook MCP Server
+
+This project is a **Modular Command Processor (MCP)** agent for automating and managing interactions on a Facebook Page using the Facebook Graph API. It exposes tools to create posts, moderate comments, fetch post insights, and filter negative feedback — ready to plug into Claude, ChatGPT, or other LLM-based agents.
+
+---
+
+## 🤖 What Is This?
+
+This MCP provides a suite of AI-callable tools that connect directly to a Facebook Page, abstracting common API operations as LLM-friendly functions.
+
+### ✅ Benefits
+
+- Empowers **social media managers** to automate moderation and analytics.
+- Seamlessly integrates with **Claude Desktop or OpenAI Agents**.
+- Enables fine-grained control over Facebook content from natural language.
+
+---
+
+## 📦 Features
+
+| Tool | Description |
+|----------------------------------|---------------------------------------------------------------------|
+| `post_to_facebook` | Create a new Facebook post with a message. |
+| `reply_to_comment` | Reply to a specific comment on a post. |
+| `get_page_posts` | Retrieve recent posts from the Page. |
+| `get_post_comments` | Fetch comments on a given post. |
+| `delete_post` | Delete a specific post by ID. |
+| `delete_comment` | Delete a specific comment by ID. |
+| `delete_comment_from_post` | Alias for deleting a comment from a specific post. |
+| `filter_negative_comments` | Filter out comments with negative sentiment keywords. |
+| `get_number_of_comments` | Count the number of comments on a post. |
+| `get_number_of_likes` | Count the number of likes on a post. |
+| `get_post_impressions` | Get total impressions on a post. |
+| `get_post_impressions_unique` | Get number of unique users who saw the post. |
+| `get_post_impressions_paid` | Get number of paid impressions on the post. |
+| `get_post_impressions_organic` | Get number of organic impressions on the post. |
+| `get_post_engaged_users` | Get number of users who engaged with the post. |
+| `get_post_clicks` | Get number of clicks on the post. |
+| `get_post_reactions_like_total` | Get total number of 'Like' reactions. |
+
+---
+
+## 🚀 Setup & Installation
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/your-org/facebook-mcp-server.git
+cd facebook-mcp-server
+```
+
+### 2. 🛠️ Installation
+
+Install dependencies using uv, a fast Python package manager:
+If uv is not already installed, run:
+```bash
+curl -Ls https://astral.sh/uv/install.sh | bash
+```
+
+Once uv is installed, install the project dependencies:
+```bash
+uv pip install -r requirements.txt
+```
+
+### 3. Set Up Environment
+
+Create a .env file in the root directory and add your Facebook Page credentials.
+You can obtain these from https://developers.facebook.com/tools/explorer
+
+```bash
+FACEBOOK_ACCESS_TOKEN=your_facebook_page_access_token
+FACEBOOK_PAGE_ID=your_page_id
+```
+
+## 🧩 Using with Claude Desktop
+To set up the FacebookMCP in Clade:
+
+1. Open Clade.
+2. Go to Settings → Developer → Edit Config.
+3. In the config file that opens, add the following entry:
+
+```bash
+"FacebookMCP": {
+ "command": "uv",
+ "args": [
+ "run",
+ "--with",
+ "mcp[cli]",
+ "--with",
+ "requests",
+ "mcp",
+ "run",
+ "/path/to/facebook-mcp-server/server.py"
+ ]
+}
+```
+
+---
+
+## ✅ You’re Ready to Go!
+
+That’s it — your Facebook MCP server is now fully configured and ready to power Claude Desktop. You can now post, moderate, and measure engagement all through natural language prompts!
+
+---
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome!
+Feel free to fork the repo and submit a pull request.
+
+- Create a branch: `git checkout -b feature/YourFeature`
+- Commit your changes: `git commit -m 'feat: add new feature'`
+- Push to the branch: `git push origin feature/YourFeature`
+- Open a pull request 🎉