Bluesky

🚀 BlueSky MCP Server

A Model Context Protocol (MCP) server that provides access to social network data on BlueSky. This server implements a standardized interface through its official API to retrieve user profile and social graph information.

✨ Features

• Retrieve detailed user profile information.
• Search for a user's follow list with pagination functionality.
• Built-in authentication handling 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 the Claude client to the MCP tool and configuring it via the JSON file, Claude should be able to view the server's profile:

• Refer to the relevant documentation or guides when starting the server.

💻 Usage Examples

get-profile

Input

{
  "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

{
  "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"
      }
    }
  }
}

🔧 Technical Details

Error Handling

This server can handle the following error conditions:

• Invalid or incorrectly formatted input.
• Requests exceeding the limit.
• Network connection issues.
• Authentication failures.

Prerequisites

• Install the necessary dependencies and libraries.
• Configure the correct environment variables.
• Ensure a stable network connection.

Authentication

To use this server, you need to:

1. Set the environment variables BLUESKY_IDENTIFIER and BLUESKY_APP_PASSWORD.
2. Ensure the validity and security of these credentials.

📄 License

This MCP server is licensed under the MIT License. This means you are free to 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.

Welcome contributions! Please feel free to submit pull requests.

If you have any questions or need further assistance, please refer to the documentation or contact the maintenance team.