Bluesky MCP Server

🚀 BlueSky MCP Server

A Model Context Protocol (MCP) server that provides data access through the official BlueSky Social Network API. This server implements standard interfaces for retrieving user profiles and social relationship information.

✨ Features

• Retrieve detailed user profile information.
• Obtain a user's following list (supports pagination).
• Built-in authentication and session management.
• Comprehensive error handling.

📦 Installation

Claude Desktop

• On MacOS: ~/Library/Application\ 支持/Claude/claude_desktop_config.json
• On 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"
            }
        }
    }

Local Run

Install Libraries

uv pip install -e .

Run

After connecting to the Claude client and configuring through the JSON file, you can run the following command:

uv run main:app --reload

Access http://localhost:8000/ to use your application.

💻 Usage Examples

get-profile

Get user profile information.

• Input Example:

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

• Output Example:

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

get-follows

Get a user's following list (supports pagination).

• Input Example:

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

• Output Example:

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

📚 Documentation

Error Handling

• 401 Unauthorized: Authentication failed. Please check if your API key is correct.
• 404 Not Found: The requested resource was not found. Please ensure that the path and parameters are correct.
• 500 Internal Server Error: An internal server error occurred. Please contact the administrator.

Prerequisites

• Install Python and pip.
• Install the necessary dependencies:

pip install fastapi uvicorn python-multipart

Authentication Information

Do not disclose the following sensitive information:

• BLUESKY_IDENTIFIER: User identifier.
• BLUESKY_APP_PASSWORD: Application password.

Contribution

Pull requests are welcome!

📄 License

This MCP server is released under the MIT License. This means you can freely use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.