Bluesky MCP Server

Name: Bluesky MCP Server
Author: semioz

@semioz

代码仓库主页

关于 Bluesky MCP Server

mcp server for bluesky. featured in offical mcp server repo.

#mcp #claude #bluesky #atproto #model-context-protocol

基本信息

分类

其他

运行时

node

传输方式

stdio

发布者

semioz

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "bluesky-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@semioz/bluesky-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Bluesky MCP Server?

The Bluesky MCP Server is a Model Context Protocol server that enables AI assistants (like Claude) to interact with Bluesky via the AT Protocol. It allows users to read and write posts, manage interactions, and view profiles and timelines through MCP-compatible clients.

How to use Bluesky MCP Server?

Install automatically via Smithery (npx -y @smithery/cli install @semioz/bluesky-mcp --client claude) or manually by adding a configuration entry to claude_desktop_config.json with environment variables BLUESKY_IDENTIFIER and BLUESKY_PASSWORD. After setup, the server auto-logs in; you can use the login tool if you need different credentials or if auto-login fails.

Key features of Bluesky MCP Server

Authenticate with Bluesky using handle/email and app password
Create text posts with optional image uploads (base64)
Retrieve single or multiple posts by URI
Delete your posts
Like/unlike and repost/unrepost content
View your profile and timeline (up to 100 posts)
Automatic link and mention detection in rich text
MCP compatible – works with Claude Desktop and other MCP clients

Use cases of Bluesky MCP Server

Let an AI assistant post updates on your Bluesky account
Automate reading and responding to your timeline
Manage likes and reposts without opening the Bluesky app
Fetch and format your timeline for review or summarization
Integrate Bluesky interactions into chat-based workflows

FAQ from Bluesky MCP Server

What environment variables do I need?

You must set BLUESKY_IDENTIFIER (your Bluesky handle or email) and BLUESKY_PASSWORD (your Bluesky app password) in the Claude Desktop config file.

When should I use the login tool?

The server auto-logs in using environment variables. Use the login tool if you haven’t set those variables, want to use different credentials, or auto-login failed.

Can I create posts with images?

Yes. The create-post tool accepts an optional images array containing base64-encoded image data and the MIME type (e.g., image/jpeg).

How do I get my timeline?

Use the get-timeline tool with an optional limit parameter (maximum 100). The format-timeline prompt can then format the returned data with author info, text, engagement metrics, timestamps, and embedded content.

How does authentication work?

Credentials are provided via environment variables or the login tool. The server uses the AT Protocol to authenticate with Bluesky; an app password is required, not your main account password.