社交媒体管理服务器

一个集成了Facebook、Instagram和Threads的社交媒体管理服务器,允许用户通过Claude Desktop直接管理多个平台的发帖、评论、私信和数据洞察。

  • by ChenLiangChong
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ChenLiangChong/mcp-social

使用说明

Social MCP Server

Facebook + Instagram + Threads 三合一 MCP Server,讓 Claude Desktop 直接管理社群媒體。

功能

平台 發文 圖片/Reel 留言管理 私訊 洞察數據
Facebook ✅ ✅ ✅ 回覆/刪除/隱藏 ✅ Messenger -
Instagram ✅ ✅ 圖片/Reel/Story ✅ 回覆/刪除/隱藏 ✅ DM ✅
Threads ✅ ✅ ✅ 回覆 - ✅
跨平台 ✅ 一鍵多平台發文 ✅ - - -

安裝

1. 建立 Python 虛擬環境

cd mcp-social
python -m venv .venv

# Windows
.venv\Scripts\activate

# macOS/Linux
source .venv/bin/activate

pip install -r requirements.txt

2. 取得 API Token

平台 需要 取得方式
Facebook Page Access Token + Page ID Meta Developer Portal → 建立 App → 產生 Page Token
Instagram 同 Facebook Token + Business Account ID 需先將 IG 帳號轉為商業帳號並連結 Facebook Page
Threads Threads Access Token Threads API → 產生 Token

3. 設定 Claude Desktop

編輯 Claude Desktop 設定(Settings → Developer → Edit Config):

Windows(WSL)

{
  "mcpServers": {
    "social": {
      "command": "wsl",
      "args": [
        "bash", "-c",
        "export FACEBOOK_ACCESS_TOKEN='你的FB_TOKEN' && export FACEBOOK_PAGE_ID='你的PAGE_ID' && export INSTAGRAM_ACCESS_TOKEN='你的IG_TOKEN' && export INSTAGRAM_BUSINESS_ACCOUNT_ID='你的IG_ACCOUNT_ID' && export THREADS_ACCESS_TOKEN='你的THREADS_TOKEN' && cd /path/to/mcp-social && .venv/bin/python server.py"
      ]
    }
  }
}

macOS / Linux

{
  "mcpServers": {
    "social": {
      "command": "/path/to/mcp-social/.venv/bin/python",
      "args": ["/path/to/mcp-social/server.py"],
      "env": {
        "FACEBOOK_ACCESS_TOKEN": "你的FB_TOKEN",
        "FACEBOOK_PAGE_ID": "你的PAGE_ID",
        "INSTAGRAM_ACCESS_TOKEN": "你的IG_TOKEN",
        "INSTAGRAM_BUSINESS_ACCOUNT_ID": "你的IG_ACCOUNT_ID",
        "THREADS_ACCESS_TOKEN": "你的THREADS_TOKEN"
      }
    }
  }
}

環境變數

變數 必填 說明
FACEBOOK_ACCESS_TOKEN FB 功能需要 Facebook Page Access Token
FACEBOOK_PAGE_ID FB 功能需要 Facebook 粉絲專頁 ID
INSTAGRAM_ACCESS_TOKEN IG 功能需要 Instagram API Token(通常和 FB Token 相同)
INSTAGRAM_BUSINESS_ACCOUNT_ID IG 功能需要 Instagram 商業帳號 ID
THREADS_ACCESS_TOKEN Threads 功能需要 Threads API Token

不需要的平台可以不設定,對應功能會回傳錯誤但不影響其他平台。

工具列表

跨平台

  • cross_post — 同時發文到多平台
  • cross_post_image — 同時發圖片到多平台
  • get_all_profiles — 一次取得三平台資料
  • get_all_posts — 一次取得三平台貼文

Facebook(fb_*)

  • fb_post / fb_post_image / fb_schedule_post
  • fb_update_post / fb_delete_post
  • fb_get_comments / fb_reply_comment / fb_delete_comment
  • fb_hide_comment / fb_unhide_comment
  • fb_get_likes / fb_get_shares / fb_get_fan_count
  • fb_send_dm

Instagram(ig_*)

  • ig_publish_image / ig_publish_reel / ig_publish_story
  • ig_get_comments / ig_reply_comment / ig_delete_comment / ig_hide_comment
  • ig_get_insights — 帳號洞察(reach/profile_views/website_clicks)
  • ig_get_post_insights — 單篇貼文洞察(Reel 自動偵測,加撈 ig_reels_avg_watch_time / ig_reels_video_view_total_time / total_interactions)
  • ig_get_conversations / ig_get_messages / ig_send_dm

Threads(threads_*)

  • threads_post / threads_post_image
  • threads_get_replies / threads_reply
  • threads_get_insights

License

MIT