social-mcp

Chrome 쿠키를 사용하여 Meta 제품군(Facebook, Instagram, Threads)을 직접 조작합니다. 완전 로컬 실행, 타사 API 토큰 불필요, OAuth 리디렉션 불필요.

기능

Related MCP server: Meta MCP Server

원리

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

핵심 혁신: Facebook 개발자 앱이 필요 없고, 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. Chrome에서 레거시 쿠키 사용 허용 (필수)

Facebook은 기본적으로 '레거시 쿠키를 사용하는 앱'을 차단하므로 수동으로 활성화해야 합니다:

1. Facebook 웹사이트 접속, 우측 상단 프로필 클릭 → 설정 및 개인정보 → 설정

2. 왼쪽 메뉴 → 보안 및 로그인

3. 아래로 스크롤하여 "레거시 쿠키를 사용하는 앱 허용" 찾기

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의 Profile 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에 연결

~/.hermes/config.yaml의 mcp 섹션에 추가하거나 직접 사용하세요:

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을 읽어 CDP WebSocket URL 획득

2. WebSocket을 통해 AIpuss의 Chrome 세션에 연결

3. CDP에서 직접 쿠키 읽기 (headless 모드에서 document.cookie 제한 우회)

장점:

• AIpuss의 Chrome에 이미 로그인 상태가 포함되어 있어 별도의 브라우저를 열 필요가 없음

• 완전 로컬 실행, 쿠키가 타사 서버를 거치지 않음

• AIpuss 데몬이 실행 중이지 않으면 자동으로 독립적인 Chrome을 실행하도록 폴백(fallback)

보안 설명

• 쿠키는 항상 로컬에 유지: social-mcp는 사용자 기기에서만 실행되며, 쿠키는 타사로 전송되지 않습니다.

• 민감한 데이터 저장 안 함: 쿠키는 메모리에만 존재하며 프로그램 종료 시 사라집니다.

• 권장: 메인 프로필이 아닌 전용 Chrome 프로필을 사용하세요.

제한 사항 및 알려진 문제

개발

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

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

# 單元測試
uv run pytest

라이선스

MIT License

주의: 본 도구는 개인 자동화 용도로만 사용하세요. Facebook/IG에 대한 대량 또는 자동화된 작업은 Meta 서비스 약관을 위반할 수 있으므로 위험을 직접 평가하시기 바랍니다.