Bluesky

🚀 BlueSky MCP 服務器

BlueSky MCP 服務器是一個提供對 BlueSky 社交網絡數據訪問的 Model Context Protocol (MCP) 服務器。它通過官方 API 實現了標準化接口，可用於獲取用戶配置資料和社交圖譜信息。

🚀 快速開始

本服務器提供了對 BlueSky 社交網絡數據的便捷訪問，藉助標準化接口，能輕鬆獲取用戶配置資料與社交圖譜信息。

✨ 主要特性

• 詳細資料獲取：獲取詳細的用戶配置資料信息。
• 關注列表檢索：檢索用戶的關注列表及其分頁功能。
• 身份驗證管理：內置的身份驗證處理和會話管理。
• 全面錯誤處理：全面的錯誤處理。

📦 安裝指南

Claude Desktop

• 在 MacOS 系統上：~/Library/Application\ 支持/Claude/claude_desktop_config.json
• 在 Windows 系統上：%APPDATA%/Claude/claude_desktop_config.json%

    "mcpServers": {
        "bluesky-mcp": {
            "command": "uv",
            "args": [
            "--directory",
            "C:\\Users\\{INSERT_USER}\\YOUR\\PATH\\TO\\bluesky-mcp\\bluesky-mcp",
            "run",
            "src/bluesky_mcp/server.py"
            ],
            "env": {
                "BLUESKY_IDENTIFIER": "your.handle.bsky.social",
                "BLUESKY_APP_PASSWORD": "your-app-password"
            }
        }
    }

本地運行

安裝庫

uv pip install -e .

運行

在連接 Claude 客戶端與 MCP 工具並通過 json 文件配置後，Claude 應該能夠看到服務器的配置資料：

• 啟動服務器時請參考相關文檔或指南。

💻 使用示例

get-profile

輸入

{
  "input": {
    "type": "string",
    "description": "The identifier for the user profile to retrieve.",
    "required": true,
    "content": {
      "schema": {
        "type": "string"
      }
    }
  },
  "output": {
    "type": "object",
    "description": "The retrieved user profile information.",
    "content": {
      "schema": {
        "$ref": "#/components/schemas/UserProfile"
      }
    }
  }
}

get-follows

輸入

{
  "input": {
    "type": "string",
    "description": "The identifier for the user whose follows we want to retrieve.",
    "required": true,
    "content": {
      "schema": {
        "type": "string"
      }
    }
  },
  "output": {
    "type": "object",
    "description": "The retrieved follow information.",
    "content": {
      "schema": {
        "$ref": "#/components/schemas/FollowInformation"
      }
    }
  }
}

🔧 技術細節

該服務器能夠處理以下錯誤情況：

• 輸入無效或格式不正確
• 超出限制的請求
• 網絡連接問題
• 身份驗證失敗

先決條件

• 安裝必要的依賴項和庫
• 配置正確的環境變量
• 確保網絡連接正常

認證

要使用該服務器，您需要：

1. 設置環境變量 BLUESKY_IDENTIFIER 和 BLUESKY_APP_PASSWORD
2. 確保這些憑據的有效性和安全性

📄 許可證

此 MCP 服務器根據 MIT 許可證授權。這意味著您可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目存儲庫中的 LICENSE 文件。

歡迎貢獻！請隨時提交拉取請求。

如果有任何問題或需要進一步的幫助，請參考文檔或聯繫維護團隊。