facebook-automata-mcp

MCP-Server (Model Context Protocol) für die offizielle Facebook-Graph-API. Stellt ein vollständiges Werkzeugset für Seiten, Beiträge, Kommentare, Likes/Reaktionen, Fotos/Videos, Veranstaltungen und Einblicke bereit, plus spezielle Werkzeuge zum Speichern und Validieren Ihrer Facebook-Anmeldedaten.

Installation und Ausführung

Keine Installation erforderlich, wenn Sie uv haben:

uvx facebook-automata-mcp

Oder mit pip installieren:

pip install facebook-automata-mcp
facebook-automata-mcp

Verwendung mit einem MCP-Client (z. B. Claude Desktop / Claude Code)

{
  "mcpServers": {
    "facebook": {
      "command": "uvx",
      "args": ["facebook-automata-mcp"]
    }
  }
}

Related MCP server: Facebook MCP Server

Anmeldedaten

Sie müssen keine Konfigurationsdatei von Hand bearbeiten. Sobald der Server mit Ihrem MCP-Client verbunden ist, bitten Sie ihn einfach (in Ihren eigenen Worten), Facebook zu konfigurieren. Er ruft dann das Tool set_facebook_credentials auf, z. B.:

„Setzen Sie meinen Facebook-Zugriffstoken auf EAAB…“

Dies wird:

1. Den Token gegen GET /me validieren.

2. Speichern Sie es in ~/.facebook-automata-mcp/credentials.json (erstellt mit 0700/0600-Berechtigungen, nur für den Besitzer).

3. Ihre validierte Identität (id/name) zurückgeben.

Felder, die Sie angeben können:

Überprüfen Sie die aktuellen Anmeldedaten jederzeit mit check_facebook_credentials (führt einen Live-Validierungsaufruf durch) oder get_credentials_status (offline, prüft nur, ob die Datei existiert). Entfernen Sie sie mit clear_facebook_credentials.

Anmeldedaten können auch über Umgebungsvariablen bereitgestellt werden, anstelle von (oder zusätzlich zu) der gespeicherten Datei – Umgebungsvariablen haben immer Vorrang:

FACEBOOK_AUTOMATA_MCP_ACCESS_TOKEN=...
FACEBOOK_AUTOMATA_MCP_APP_ID=...
FACEBOOK_AUTOMATA_MCP_APP_SECRET=...
FACEBOOK_AUTOMATA_MCP_PAGE_ID=...
FACEBOOK_AUTOMATA_MCP_API_VERSION=v21.0
FACEBOOK_AUTOMATA_MCP_HOME=/custom/path   # overrides ~/.facebook-automata-mcp

Ein Token erhalten

Der schnellste Weg für eine Seite ist Metas Graph-API-Explorer: Wählen Sie Ihre App, generieren Sie ein Benutzer-Zugriffstoken mit pages_show_list, pages_read_engagement, pages_read_user_content, pages_manage_posts und pages_manage_engagement, rufen Sie dann hier get_my_accounts auf, um das eigene (seitenbezogene) Zugriffstoken Ihrer Seite abzurufen, und verwenden Sie dieses als access_token für Tools auf Seitenebene.

Werkzeuge

Anmeldedaten

• set_facebook_credentials — Token speichern + validieren

• check_facebook_credentials — Live-Validierung + /debug_token-Informationen

• get_credentials_status — Offline-Prüfung

• clear_facebook_credentials — gespeicherte Anmeldedaten löschen

Identität

• get_my_profile, get_user_profile, get_my_accounts

Seiten

• search_pages, get_page_info, get_page_posts, get_page_feed, get_page_tagged_posts, get_page_events, get_page_photos, get_page_videos, get_page_albums, get_page_insights

Beiträge

• get_post, publish_page_post, delete_post

Kommentare

• get_post_comments (enthält, wer kommentiert hat), get_comment, get_comment_replies, publish_comment, reply_to_comment, delete_comment, hide_comment

Likes / Reaktionen

• get_post_likes, get_post_reactions (wer + welche Reaktion), get_comment_likes, get_comment_reactions, like_object, unlike_object

Medien

• upload_page_photo, upload_page_video

Notausstieg

• graph_api_get, graph_api_post, graph_api_delete — jede nicht oben abgedeckte Graph-API-Kante aufrufen

Alle listenartigen Tools akzeptieren limit und after (Paginierungscursor aus dem next_cursor des vorherigen Aufrufs) und geben {ok, data, paging, next_cursor} zurück.

Hinweise zu Einschränkungen der Facebook-API

• Moderne Graph-API-Versionen schränken die meisten Felder persönlicher Profile und die klassischen Daten „Wer hat das geliked / Freundesliste“ für normale Benutzer aus Datenschutzgründen ein – Inhalte im Besitz von Seiten (Seitenbeiträge, deren Kommentare und Reaktionen) sind der primär unterstützte Anwendungsfall.

• Einige Aktionen (Posten, Löschen, Kommentare ausblenden, Einblicke) erfordern ein Seiten-Zugriffstoken mit den entsprechenden Berechtigungen (pages_manage_posts, pages_manage_engagement, read_insights usw.) und für öffentliche Apps die Meta-App-Prüfung.

Entwicklung

python -m venv .venv && source .venv/bin/activate
pip install -e .
facebook-automata-mcp

Auf PyPI veröffentlichen

pip install build twine
python -m build
twine upload dist/*

Sobald es veröffentlicht ist, kann jeder es mit uvx facebook-automata-mcp ausführen, ohne etwas dauerhaft zu installieren.

Lizenz

MIT