social-mcp

Прямое управление экосистемой Meta (Facebook, Instagram, Threads) с помощью файлов cookie Chrome. Полностью локальный запуск, не требуются сторонние API-токены или OAuth-перенаправления.

Функции

Related MCP server: Facebook Messenger MCP Bridge

Принцип работы

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

Ключевая инновация: не требуется приложение Facebook Developer, не нужен PAGE_ACCESS_TOKEN, используется реальное состояние входа в вашем Chrome.

Системные требования

• Python 3.11+

• Chrome или Chromium (с выполненным входом в Facebook)

• macOS / Linux

• Рекомендуется: запущенный демон AIpuss-browser (social-mcp автоматически обнаружит и повторно использует соединение CDP)

Установка

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

# 用 uv 安裝（推薦）
uv sync

# 或用 pip
pip install -e .

Настройка

1. Разрешение использования устаревших файлов cookie в Chrome (обязательно)

Facebook по умолчанию блокирует «приложения, использующие устаревшие файлы cookie», это нужно включить вручную:

1. Откройте веб-сайт Facebook, нажмите на аватар в правом верхнем углу → Настройки и конфиденциальность → Настройки

2. Меню слева → Безопасность и вход

3. Прокрутите вниз, найдите «Разрешить приложениям использовать устаревшие файлы cookie»

4. Переключите в положение «Вкл.»

Если этого параметра нет, значит, ваша учетная запись разрешает это по умолчанию, переходите к следующему шагу.

2. Настройка переменных окружения (опционально)

# .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. Проверка входа в Chrome

Убедитесь, что в вашем профиле Chrome 3 (имя MY) выполнен вход в Facebook и Instagram. Если используется демон AIpuss-browser, он по умолчанию будет считывать этот профиль.

Использование

Запуск MCP-сервера

# 基本啟動
uv run social-mcp

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

Подключение к Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Перезапустите Claude Desktop, после чего вы сможете использовать все вышеперечисленные инструменты в диалоге.

Подключение к Hermes Agent

Добавьте в блок mcp файла ~/.hermes/config.yaml или используйте напрямую:

hermes tools enable social

Примеры использования инструментов

你：幫我發一篇 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="好的，明天見")
       → ✅ 訊息已發送

Об интеграции с AIpuss-browser

social-mcp автоматически обнаруживает демон AIpuss-browser:

1. Считывает ~/.agent-browser/default.stream для получения URL WebSocket CDP

2. Подключается к сессии Chrome в AIpuss через WebSocket

3. Считывает файлы cookie напрямую из CDP (обходя ограничения document.cookie в headless-режиме)

Преимущества:

• Chrome в AIpuss уже содержит ваше состояние входа, не нужно открывать отдельный браузер

• Полностью локальный запуск, файлы cookie не передаются на сторонние серверы

• Если демон AIpuss не запущен, автоматически произойдет откат к запуску отдельного экземпляра Chrome

Безопасность

• Файлы cookie всегда остаются локально: social-mcp работает только на вашем компьютере, файлы cookie не передаются третьим лицам

• Никакие конфиденциальные данные не сохраняются: файлы cookie существуют только в оперативной памяти и исчезают после завершения программы

• Рекомендация: используйте отдельный профиль Chrome, а не основной

Ограничения и известные проблемы

Разработка

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

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

# 單元測試
uv run pytest

Лицензия

MIT License

Примечание: данный инструмент предназначен только для личной автоматизации. Массовые или автоматизированные действия в Facebook/IG могут нарушать Условия обслуживания Meta, пожалуйста, оценивайте риски самостоятельно.