Bluesky MCP Server

这是一个连接到 Bluesky 并提供与 ATProtocol 交互工具的 Model Context Protocol 服务器。

您可以使用此 MCP 服务器将来自各种 Bluesky / ATProtocol API 端点的内容直接带入基于 LLM 的应用程序的上下文窗口。例如，您可以将此服务器添加到 Claude Desktop 中，然后将其用作自然语言的 Bluesky 客户端。

功能与工具

• 通过自然语言与常见的 Bluesky 功能进行交互（例如，“获取 David Roberts 的最新帖子”）
• 获取并分析订阅源（“给我找一个关于西雅图的订阅源，并告诉我人们在讨论什么”）
• 获取并分析关注者列表（“Mark Cuban 关注的是哪些类型的账户？给我一份详细的报告”）
• 使用 LLM 编写帖子并为您发布 😱（“写一首关于我所在地区今天天气的俳句，并发布到 Bluesky 上”）
• 搜索订阅源、帖子和人员（“找到关于 #teslatakedown 的帖子，并给我最近事件的总结”）
• 分析谁在关注您？（“谁在我的 Bluesky 上关注我？给我一份报告”）

以下是当前提供的工具列表：

• get-pinned-feeds：返回已认证用户偏好设置中的所有“固定”项目集。
• get-timeline-posts：返回已认证用户的主页时间线上的帖子。
• get-feed-posts：返回指定订阅源中的帖子。
• get-list-posts：返回指定列表中的帖子。
• get-user-posts：返回指定用户的帖子。
• get-profile：返回指定用户的个人资料详细信息。
• get-follows：返回一个账户关注的用户集。
• get-followers：返回关注一个账户的用户集。
• get-liked-posts：返回已认证用户喜欢的近期帖子。
• get-trends：返回 Bluesky 上当前热门话题及其帖子数量。
• get-post-thread：返回特定帖子的完整对话线程，显示所有回复和上下文。
• convert-url-to-uri：将 Bluesky 网页 URL 转换为可以与其他工具一起使用的 AT URI 格式。
• search-posts：返回给定查询的帖子。可以选择最新的或最热门的。
• search-people：返回给定搜索查询的人。
• search-feeds：返回给定查询的订阅源。
• like-post：点赞具有特定 URI 的帖子。
• create-post：发布帖子。
• follow-user：关注特定用户。

提示：

• 您可以根据时间范围从搜索、时间线、列表、订阅源或个人资料中请求帖子。例如：“总结过去三天我的时间线上的帖子”或“找到本周人们谈论过的最有趣的帖子”。
• 尝试一些奇怪的问题：“在过去24小时内，我在时间线上看到的最有趣/最疯狂/最奇怪/最搞笑的帖子是什么？”
• 了解自己：“分析我喜欢的帖子，并告诉我我对什么感兴趣。给我三个关于您发现的有趣事实以及它们如何与我在 Bluesky 上的性格相关联。” 或 “谁在我的 Bluesky 上关注我？给我一份全面的报告。”

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Bluesky MCP Server 到 Claude Desktop：

npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude

手动安装

首先克隆这个仓库，然后安装依赖项并构建服务器：

# 安装依赖项
pnpm install

# 构建项目
pnpm run build

使用 MCP Inspector 测试

您可以通过令人惊叹的 MCP Inspector 直接测试 Bluesky 工具，而无需连接到 LLM。首先确保已经构建了服务器，然后运行：

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

导航到终端提供的本地 URL，然后从左侧面板设置您的 BLUESKY_IDENTIFIER、BLUESKY_APP_PASSWORD 和 BLUESKY_SERVICE_URL 环境变量。尝试 get-timeline 工具以查看您主页时间线上的最新帖子。

MCP 客户端配置

按照步骤设置您选择的客户端的 MCP。例如，要设置桌面版 Claude 连接到 Bluesky，请在您的 claude_desktop_config.json 文件的 bluesky 部分添加以下内容：

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

有关在桌面版 Claude 中运行 MCP 服务器的更多详细信息，请参阅 https://modelcontextprotocol.io/quickstart/user

创建应用密码

要使用此 MCP 服务器，您需要为您的 Bluesky 账户创建一个应用密码：

1. 登录 Bluesky
2. 前往设置 > 应用密码
3. 为此次集成创建一个新的应用密码
4. 使用 BLUESKY_APP_PASSWORD 环境变量设置应用密码

安全注意事项

• 此服务器仅在内存中存储会话信息，并且不会与 MCP 客户端共享。
• MCP 客户端仅对工具有访问权限，而不是对您的身份验证或应用密码有访问权限。

许可证

MIT