使用说明
Social MCP Server
Facebook + Instagram + Threads 三合一 MCP Server,讓 Claude Desktop 直接管理社群媒體。
功能
| 平台 | 發文 | 圖片/Reel | 留言管理 | 私訊 | 洞察數據 |
|---|---|---|---|---|---|
| ✅ | ✅ | ✅ 回覆/刪除/隱藏 | ✅ Messenger | - | |
| ✅ | ✅ 圖片/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
| 平台 | 需要 | 取得方式 |
|---|---|---|
| Page Access Token + Page ID | Meta Developer Portal → 建立 App → 產生 Page Token | |
| 同 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_postfb_update_post/fb_delete_postfb_get_comments/fb_reply_comment/fb_delete_commentfb_hide_comment/fb_unhide_commentfb_get_likes/fb_get_shares/fb_get_fan_countfb_send_dm
Instagram(ig_*)
ig_publish_image/ig_publish_reel/ig_publish_storyig_get_comments/ig_reply_comment/ig_delete_comment/ig_hide_commentig_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_imagethreads_get_replies/threads_replythreads_get_insights
License
MIT