Bluesky Context Server MCP Server

Bluesky Context Server is a Model Context Protocol (MCP) server that enables AI assistants to query and interact with Bluesky social network instances. This integration allows AI models to retrieve posts, user information, and other data from the Bluesky platform, enhancing their ability to provide relevant information about Bluesky content and users. The server is built with TypeScript and runs on Bun, providing a lightweight and efficient connection between AI assistants and the Bluesky API. It can be installed either manually or via Smithery, making it accessible for both technical and non-technical users.

Overview

Bluesky Context Server allows AI assistants to access and interact with the Bluesky social network. This integration enables AI models to retrieve information from Bluesky, providing context about posts, users, and other content on the platform.

Installation Options

Option 1: Install via Smithery (Recommended)

The easiest way to install Bluesky Context Server is through Smithery, which automates the setup process:

Open your terminal

Run the following command:

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

Follow any on-screen prompts to complete the installation

Option 2: Manual Installation

If you prefer to install manually:

Clone the repository to your local machine:

git clone https://github.com/laulauland/bluesky-context-server.git

Navigate to the cloned directory:
```
cd bluesky-context-server
```
Install dependencies using Bun:
```
bun install
```

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

Configuration

To use the Bluesky Context Server, you'll need to configure the following environment variables:

BLUESKY_APP_KEY: Your Bluesky API key
BLUESKY_IDENTIFIER: Your Bluesky identifier

These can be set in the config.json file as shown above.

Usage

Once installed and configured, the Bluesky Context Server will be available to your AI assistant. You can ask the assistant to retrieve information from Bluesky, such as:

Looking up user profiles
Fetching recent posts
Searching for specific content
Getting information about trends

The server handles the communication between your AI assistant and the Bluesky API, allowing for seamless integration.

Troubleshooting

If you encounter issues with the Bluesky Context Server:

Verify that your environment variables are correctly set
Ensure that Bun is properly installed on your system
Check that the paths in your config.json file are correct
Restart your AI assistant application after making changes

For further assistance, you can check the GitHub repository or submit an issue there.

Bluesky Context Server MCP Server

queryBluesky