Overview

Bluesky Context Server is a lightweight MCP server that enables AI assistants to query and interact with Bluesky social network instances. This integration allows AI models to access content from the Bluesky platform, enhancing their ability to provide up-to-date information from this decentralized social network.

Installation Options

Option 1: Install via Smithery (Recommended)

The easiest way to install Bluesky Context Server for Claude Desktop is through Smithery:

npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude

This command automatically configures the MCP server for use with Claude Desktop.

Option 2: Manual Installation

If you prefer to install manually:

1. Clone the repository or download the code to your local machine
2. Make sure you have Bun installed as a runtime
3. Configure your Claude Desktop app by editing the config.json file:

// ~/Library/Application Support/Claude/config.json
{
  "mcpServers": {
    "bluesky": {
      "command": "/path/to/bun",
      "args": [
        "/path/to/bluesky-context-server/index.ts"
      ],
      "env": {
        "BLUESKY_APP_KEY": "",
        "BLUESKY_IDENTIFIER": ""
      }
    }
  }
}

Replace /path/to/bun with the actual path to your Bun executable and /path/to/bluesky-context-server with the path where you saved the repository.

Configuration

The server requires the following environment variables:

• BLUESKY_APP_KEY: Your Bluesky application key
• BLUESKY_IDENTIFIER: Your Bluesky identifier

You can set these in the config.json file as shown above.

Usage

Once installed and configured, Claude will be able to access Bluesky content when needed. The MCP server handles the communication between Claude and the Bluesky platform, allowing Claude to retrieve posts, user information, and other content from Bluesky.

Requirements

• Bun runtime
• Claude Desktop application
• Bluesky account credentials (for API access)

Troubleshooting

If you encounter issues with the Bluesky Context Server:

1. Verify that your Bluesky credentials are correct
2. Check that the paths in your config.json file are accurate
3. Ensure Bun is properly installed on your system
4. Restart the Claude Desktop application after making configuration changes

License

This project is available under the MIT license.