Bluesky MCP Server

🚀 藍天 MCP 服務器

藍天 MCP 服務器是一個藉助藍天社交網絡（BlueSky）官方 API 來提供數據訪問的模型上下文協議 (MCP) 服務器。它實現了獲取用戶資料和社交關係信息的標準接口，為用戶提供了便捷的數據獲取途徑。

🚀 快速開始

在使用藍天 MCP 服務器之前，需要完成一些先決條件的準備，並且要注意認證信息的保護。

先決條件

• 安裝 Python 和 pip。
• 安裝必要的依賴項：

pip install fastapi uvicorn python-multipart

認證信息

⚠️ 重要提示

請勿洩露以下敏感信息：

• BLUESKY_IDENTIFIER：用戶標識符。
• BLUESKY_APP_PASSWORD：應用密碼。

✨ 主要特性

• 獲取詳細的用戶資料信息
• 獲取用戶的關注列表（支持分頁）
• 內置的身份驗證和會話管理
• 全面的錯誤處理

📦 安裝指南

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 客戶端並通過 JSON 文件配置後，可以運行以下命令：

uv run main:app --reload

訪問 http://localhost:8000/ 來使用你的應用。

💻 使用示例

基礎用法

get-profile

獲取用戶資料信息。

• 輸入示例：

{
  "name": "John Doe",
  "email": "john@example.com",
  "phone": "+1234567890"
}

• 輸出示例：

{
  "user_id": "12345",
  "display_name": "John Doe",
  "bio": "Tech enthusiast | OpenAI Developer",
  "created_at": "2023-10-10T12:00:00Z"
}

get-follows

獲取用戶的關注列表（支持分頁）。

• 輸入示例：

{
  "user_id": "12345",
  "page": 1,
  "per_page": 10
}

• 輸出示例：

{
  "users": [
    {
      "user_id": "67890",
      "display_name": "Jane Smith",
      "bio": "AI Engineer at XYZ Corp"
    }
    // 其他用戶...
  ],
  "total_pages": 5,
  "current_page": 1
}

📚 詳細文檔

錯誤處理

• 401 Unauthorized：認證失敗。請檢查 API 密鑰是否正確。
• 404 Not Found：請求的資源未找到。請確保路徑和參數正確。
• 500 Internal Server Error：服務器內部錯誤。請聯繫管理員。

📄 許可證

本 MCP 服務器根據 MIT 許可證發佈。這意味著你可以自由使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。更多詳情，請參閱項目倉庫中的 LICENSE 文件。

貢獻

歡迎提交 Pull Request！