social-mcp

Steuern Sie die Meta-Produktfamilie (Facebook, Instagram, Threads) direkt mit Chrome-Cookies. Läuft vollständig lokal, benötigt keine Drittanbieter-API-Token und keine OAuth-Weiterleitungen.

Funktionen

Related MCP server: Meta MCP Server

Funktionsweise

你的 Chrome（已登入 Facebook）
    ↓ CDP (Chrome DevTools Protocol)
social-mcp 讀取 cookies
    ↓
直接 call Facebook Graph API（用 cookie session）
    ↓
完成發帖 / 讀取收件箱 / 發 IG / 發 Threads

Kerninnovation: Kein Facebook Developer App erforderlich, kein PAGE_ACCESS_TOKEN nötig, nutzt direkt Ihren echten Anmeldestatus aus Chrome.

Voraussetzungen

• Python 3.11+

• Chrome oder Chromium (bei Facebook angemeldet)

• macOS / Linux

• Empfohlen: AIpuss-browser Daemon aktiviert (social-mcp erkennt und verwendet die CDP-Verbindung automatisch)

Installation

# clone 並進入目錄
git clone https://github.com/whypuss/social-mcp.git
cd social-mcp

# 用 uv 安裝（推薦）
uv sync

# 或用 pip
pip install -e .

Konfiguration

1. Verwendung von Legacy-Cookies in Chrome erlauben (erforderlich)

Facebook blockiert standardmäßig „Apps, die Legacy-Cookies verwenden“. Dies muss manuell aktiviert werden:

1. Öffnen Sie die Facebook-Webseite, klicken Sie oben rechts auf Ihr Profilbild → Einstellungen und Privatsphäre → Einstellungen

2. Linkes Menü → Sicherheit und Login

3. Scrollen Sie nach unten und suchen Sie nach „Apps erlauben, die Legacy-Cookies verwenden“

4. Auf „Ein“ stellen

Wenn diese Option nicht vorhanden ist, bedeutet dies, dass Ihr Konto dies standardmäßig erlaubt. Fahren Sie mit dem nächsten Schritt fort.

2. Umgebungsvariablen festlegen (optional)

# .env 檔（放在 social-mcp/ 目錄下）
cp .env.example .env
nano .env

# Facebook 粉絲頁 ID（可從粉絲頁網址取得）
# 例如：https://www.facebook.com/MyPage → FACEBOOK_PAGE_ID=MyPage
FACEBOOK_PAGE_ID=你的頁面ID

# Instagram Business 帳號 ID（從 Meta Business Suite 取得）
IG_USER_ID=你的IG帳號數字ID

3. Sicherstellen, dass Chrome angemeldet ist

Stellen Sie sicher, dass Ihr Chrome-Profil 3 (Name MY) bei Facebook und Instagram angemeldet ist. Wenn Sie den AIpuss-browser Daemon verwenden, liest dieser standardmäßig dieses Profil.

Verwendung

MCP-Server starten

# 基本啟動
uv run social-mcp

# 除錯模式（看完整日誌）
uv run social-mcp --debug

Mit Claude Desktop verbinden

Fügen Sie dies in ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "social": {
      "command": "uv",
      "args": ["run", "--project", "/路徑/到/social-mcp", "social-mcp"]
    }
  }
}

Starten Sie Claude Desktop neu, um alle oben genannten Tools im Chat zu verwenden.

Mit Hermes Agent verbinden

Fügen Sie es im mcp-Block in ~/.hermes/config.yaml hinzu oder verwenden Sie direkt:

hermes tools enable social

Anwendungsbeispiele für Tools

你：幫我發一篇 Facebook 帖：「測試成功！」
Agent → post_facebook(message="測試成功！")
       → ✅ 成功！URL: https://www.facebook.com/123456789

你：讀取最新的 Messenger 訊息
Agent → get_messenger_inbox(limit=5)
       → ## Messenger 收件箱（5筆）
         1. [2026-04-24 10:00] 王小明：明天開會嗎？
         2. [2026-04-24 09:45] 李小美：收到了，謝謝！

你：回覆王大明（ID: 100001234567890）說「好的，明天見」
Agent → send_messenger(thread_id="100001234567890", message="好的，明天見")
       → ✅ 訊息已發送

Über die AIpuss-browser Integration

social-mcp erkennt den AIpuss-browser Daemon automatisch:

1. Liest ~/.agent-browser/default.stream, um die CDP-WebSocket-URL zu erhalten

2. Verbindet sich über WebSocket mit der Chrome-Sitzung von AIpuss

3. Liest Cookies direkt über CDP (umgeht die Einschränkungen von document.cookie im Headless-Modus)

Vorteile:

• Der Chrome-Browser von AIpuss enthält bereits Ihren Anmeldestatus, es muss kein zusätzlicher Browser geöffnet werden

• Läuft vollständig lokal, Cookies werden nicht an Drittanbieter-Server gesendet

• Falls der AIpuss-Daemon nicht läuft, wird automatisch auf einen eigenständigen Chrome-Browser zurückgegriffen

Sicherheitshinweise

• Cookies bleiben immer lokal: social-mcp läuft nur auf Ihrem eigenen Rechner, Cookies werden nicht an Dritte übertragen

• Keine Speicherung sensibler Daten: Cookies existieren nur im Arbeitsspeicher und verschwinden nach Beendigung des Programms

• Empfehlung: Verwenden Sie ein dediziertes Chrome-Profil anstelle Ihres Hauptprofils

Einschränkungen und bekannte Probleme

Entwicklung

# 安裝開發依賴
uv sync --extra dev

# 程式碼檢查
uv run ruff check social_mcp/

# 單元測試
uv run pytest

Lizenz

MIT License

Hinweis: Dieses Tool ist nur für den persönlichen Automatisierungsgebrauch bestimmt. Massenhafte oder automatisierte Aktionen auf Facebook/IG können gegen die Nutzungsbedingungen von Meta verstoßen. Bitte bewerten Sie die Risiken selbst.