social-mcp

social-mcp ist ein kostenloser, selbst gehosteter MCP-Server, mit dem Claude dein Instagram-Konto und deine Facebook-Seite betreuen kann. Du legst Fotos in einen Ordner und sagst Claude, was wann veröffentlicht werden soll. Claude bereitet die Beiträge dann vor, lädt sie hoch, archiviert und plant sie.

Der Veröffentlichungsserver läuft auf deinem eigenen Rechner. Er schickt Veröffentlichungsanfragen und ausgewählte Medien an Meta. Wie dein KI-Client mit deinen Daten umgeht, hängt von dessen Anbieter und Konfiguration ab.

Quellcode: github.com/bmachek/social-mcp · Setup-Anleitung · Issues

Was ist MCP?

Das Model Context Protocol ist ein Standard, über den KI-Assistenten auf externe Werkzeuge zugreifen. social-mcp setzt ihn um. Claude Code oder Claude Desktop verbindet sich mit dem Server und erhält Werkzeuge zum Veröffentlichen, Planen und Auswerten, die die Meta Graph API nutzen.

Funktionen

• Sofort veröffentlichen: Fotos, Karussells (2–10 Bilder) und Reels auf Instagram, auf einer Facebook-Seite oder auf beiden gleichzeitig.
• Für später planen: Beiträge für einen festen oder einen relativen Zeitpunkt einplanen (in 2h, tomorrow at 19:30). Der Zeitplan wird dauerhaft gespeichert und übersteht Neustarts des Containers.
• Auswertung: Reichweite, Engagement und Follower-Zahlen für das Konto, Kennzahlen pro Beitrag (Likes, Kommentare, Shares, Speicherungen, Wiedergaben) und eine Rangliste deiner erfolgreichsten Beiträge.
• Autopilot: durchsucht deinen Eingangsordner, entfernt doppelte Serienaufnahmen per Perceptual Hash, fasst Fotos, die zeitlich und örtlich nah beieinander entstanden sind, zu Karussells zusammen und schlägt einen Zeitplan für zwei Wochen vor. Du prüfst den Plan und schreibst die Bildunterschriften. Ein Commit stellt dann alles in die Warteschlange.
• Selbst gehostete Veröffentlichung: Dein Meta-Token steht in einer lokalen .env-Datei und authentifiziert die Anfragen an Meta. Bei lokalen Dateien stellt ein nginx-Sidecar jedes Bild kurz unter einer einmaligen öffentlichen URL bereit, damit Meta es abrufen kann. Danach entfernt er die URL wieder und archiviert die Datei.

Voraussetzungen

• Eine Meta-App (Typ: Business) mit Facebook Login for Business und der Instagram Graph API
• Ein langlebiger User Access Token mit den Berechtigungen (Scopes) pages_show_list, pages_read_engagement, pages_manage_posts, instagram_basic und instagram_content_publish
• Docker Compose (empfohlen) oder Python 3.8+
• Ein verbundenes Instagram-Business- oder -Creator-Konto und eine Facebook-Seite

Einrichtung

1. Erstelle eine Meta-App und erzeuge einen langlebigen User Access Token mit den oben genannten Berechtigungen.
2. Kopiere .env.example nach .env und trage deinen Token, die Page-ID und die Instagram-User-ID ein.
3. Führe docker compose up -d --build aus. Damit starten der MCP-Server (Standardport 3224) und ein nginx-Sidecar für Dateien (Standardport 3223).
4. Registriere den Server in deinem MCP-Client (Claude Code oder Claude Desktop).

Die Setup-Anleitung beschreibt jeden Schritt im Detail: die Meta-App anlegen, den Token erzeugen, .env konfigurieren und einen Reverse Proxy einrichten.

Nutzung

Sobald der Server verbunden ist, sprichst du Claude in normaler Sprache an, zum Beispiel:

• „Veröffentliche das Sonnenuntergangsfoto aus meinem Eingangsordner mit dieser Bildunterschrift auf Instagram und Facebook und füge es meiner Story hinzu.“
• „Plane diese drei Fotos als Instagram-Karussell für morgen um 19:30 Uhr ein.“
• „Plane die nächsten zwei Wochen aus meinem Eingangsordner und zeig mir dann, welche Karussells du bilden würdest.“

Eine Schritt-für-Schritt-Anleitung steht im Artikel Instagram und Facebook mit Claude und social-mcp verwalten.

social-mcp hat keine eingebaute Authentifizierung. Beschränke den Zugriff auf Netzwerkebene oder setze einen Reverse Proxy mit TLS-Terminierung und Bearer-Token-Prüfung davor, wenn du den Server außerhalb deines LANs erreichbar machst.

Lizenz

social-mcp ist kostenlos und selbst gehostet. Der Quellcode liegt auf GitHub.