Bluesky MCP 服务器

这是一个 模型上下文协议 服务器，它连接到 Bluesky 并提供与 AT 协议交互的工具。

你可以使用这个 MCP 服务器将来自各种 Bluesky / AT 协议 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小时的时间线上，你见过最搞笑/最失控/最奇怪/最滑稽的帖子是什么？”
• 了解自己：“分析我喜欢的帖子并告诉我我对什么感兴趣。给我3个关于你的发现的有趣事实以及它们如何与我在Bluesky上的个性相关联。” 或 “谁在Bluesky上关注了我？给我一个全面的报告。”

安装

通过Smithery安装

要通过Smithery自动安装适用于Claude Desktop的Bluesky MCP服务器，请运行：

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

手动安装

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

# Install dependencies
pnpm install

# Build the project
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