Bluesky Social MCP

🚀 Bluesky Social MCP

Bluesky Social MCP 是一個 MCP 服務器，藉助 atproto 客戶端與 Bluesky 社交網絡進行交互。

:wave: 如果在運行此 MCP 時遇到任何問題，請提交一個 issue。我應該能夠很快推出修復方案。

🚀 快速開始

在以下鏈接獲取你的 Bluesky 應用密碼：https://bsky.app/settings/app-passwords

將以下內容添加到你的 MCP 配置文件中（注意版本已固定）：

{
  "mcpServers": {
    "bluesky-social": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/gwbischof/bluesky-social-mcp@v0.1", "bluesky-social-mcp"],
      "env": {
        "BLUESKY_IDENTIFIER": "your-handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

• 出於安全考慮，我認為最好固定版本，並手動更改配置以更新版本。

✨ 工具狀態

所有工具均已實現並通過測試 ✅

身份驗證與設置

• ✅ check_auth_status - 檢查當前會話是否已通過身份驗證

個人資料操作

• ✅ get_profile - 獲取用戶個人資料（客戶端方法：get_profile）
• ✅ get_follows - 獲取賬戶關注的用戶（客戶端方法：get_follows）
• ✅ get_followers - 獲取關注賬戶的用戶（客戶端方法：get_followers）
• ✅ follow_user - 關注用戶（客戶端方法：follow）
• ✅ unfollow_user - 取消關注用戶（客戶端方法：unfollow）
• ✅ mute_user - 靜音用戶（客戶端方法：mute）
• ✅ unmute_user - 取消靜音用戶（客戶端方法：unmute）
• ✅ resolve_handle - 將句柄解析為 DID（客戶端方法：resolve_handle）

動態操作

• ✅ get_timeline - 從你的主頁動態獲取帖子（客戶端方法：get_timeline）
• ✅ get_author_feed - 獲取特定用戶的帖子（客戶端方法：get_author_feed）
• ✅ get_post_thread - 獲取完整的對話線程（客戶端方法：get_post_thread）

帖子互動

• ✅ like_post - 點贊帖子（客戶端方法：like）
• ✅ unlike_post - 取消點贊帖子（客戶端方法：unlike）
• ✅ get_likes - 獲取帖子的點贊數（客戶端方法：get_likes）
• ✅ repost - 轉發帖子（客戶端方法：repost）
• ✅ unrepost - 取消轉發帖子（客戶端方法：unrepost）
• ✅ get_reposted_by - 獲取轉發帖子的用戶（客戶端方法：get_reposted_by）

帖子創建與管理

• ✅ send_post - 創建新的文本帖子（客戶端方法：send_post）
• ✅ send_image - 發送帶有單張圖片的帖子（客戶端方法：send_image）
• ✅ send_images - 發送帶有多張圖片的帖子（客戶端方法：send_images）
• ✅ send_video - 發送帶有視頻的帖子（客戶端方法：send_video）
• ✅ delete_post - 刪除帖子（客戶端方法：delete_post）
• ✅ get_post - 獲取特定帖子（客戶端方法：get_post）
• ✅ get_posts - 獲取多個帖子（客戶端方法：get_posts）

從本地克隆的倉庫運行

{
    "mcpServers": {
        "bluesky-social": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/bluesky-social-mcp",
                "run",
                "server.py"
            ],
            "env": {
                "BLUESKY_IDENTIFIER": "user-name.bsky.social‬",
                "BLUESKY_APP_PASSWORD": "app-password-here"
            }
        }
    }
}

📦 安裝指南

開發環境設置

1. 安裝依賴：

   uv sync
   

2. 運行服務器：

   uv run bluesky-social-mcp
   

使用 MCP 檢查器進行調試

mcp dev server.py
mcp dev server.py --with-editable .

運行測試

• 我針對實際的 Bluesky 服務器運行測試。
• 測試將使用 BLUESKY_IDENTIFIER 和 BLUESKY_APP_PASSWORD 環境變量。

uv run pytest