Bluesky MCP Server for ATProtocol Integration

Overview

The Bluesky MCP Server is a Model Context Protocol server designed to connect to Bluesky and interact with the ATProtocol. It enables users to bring context from various Bluesky/ATProtocol API endpoints directly into the context window of their LLM-based applications. For example, it can be integrated with Claude Desktop to function as a natural language Bluesky client.

Features & Tools

The server provides a wide range of tools to interact with Bluesky features via natural language. Key capabilities include:

• Fetching and analyzing feeds, posts, and user profiles.
• Writing and publishing posts using an LLM.
• Searching for feeds, posts, and people.
• Managing likes and follows.

Tools Provided

• get-pinned-feeds: Returns pinned items from the authenticated user's preferences.
• get-timeline-posts: Retrieves posts from the authenticated user's home timeline.
• get-feed-posts: Fetches posts from a specified feed.
• get-list-posts: Retrieves posts from a specified list.
• get-user-posts: Fetches posts from a specified user.
• get-profile: Returns profile details of a specified user.
• get-follows: Retrieves the set of users followed by a specified user.
• get-liked-posts: Returns recent posts liked by the authenticated user.
• get-trends: Fetches current trending topics on Bluesky.
• search-posts: Searches for posts based on a query.
• search-people: Searches for users based on a query.
• search-feeds: Searches for feeds based on a query.
• like-post: Likes a post with a specific URI.
• create-post: Publishes a post.
• follow-user: Follows a specific user.

Installation

To set up the server, follow these steps:

# Install dependencies
pnpm install

# Build the project
pnpm run build

Testing with MCP Inspector

You can test the Bluesky tools directly using the MCP Inspector. After building the server, run:

npx @modelcontextprotocol/inspector node build/src/index.js

Navigate to the local URL provided in your terminal and configure your environment variables to test the tools.

MCP Client Configuration

To integrate the server with your MCP client, such as Claude Desktop, add the following configuration to your claude_desktop_config.json:

{
    "mcpServers": {
      "bluesky": {
        "command": "node",
        "args": ["/path/to/bsky-mcp-server/build/src/index.js"],
        "env": {
            "BLUESKY_IDENTIFIER": "your-bluesky-handle",
            "BLUESKY_APP_PASSWORD": "your-app-password",
            "BLUESKY_SERVICE_URL": "https://bsky.social"
          }
      }
    }
  }

For more details, refer to the MCP Quickstart Guide.

Creating App Passwords

To use the server, you need to create an app password for your Bluesky account:

1. Log in to Bluesky.
2. Go to Settings > App Passwords.
3. Create a new app password specifically for this integration.
4. Set the app password using the BLUESKY_APP_PASSWORD environment variable.

Security Notes

• The server stores session information in memory only and does not share it with the MCP client.
• The MCP client only has access to the tools, not to your authentication or app password.

License

This project is licensed under the MIT License.

About

The Bluesky MCP Server is an open-source project designed to enhance the capabilities of LLM-based applications by integrating with Bluesky and the ATProtocol. For more information, visit the GitHub repository.

Resources

• Readme
• Activity

Stats

• Stars: 4
• Watchers: 1
• Forks: 1

Languages

• TypeScript: 59.0%
• JavaScript: 40.7%
• Shell: 0.3%