Bluesky MCP 服务器

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

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

功能 & 工具

• 通过自然语言与常见的 Bluesky 功能交互（例如，“获取 David Roberts 最近的帖子”）
• 获取和分析动态消息（“为我找到一个关于西雅图的动态消息，并告诉我人们在谈论什么”）
• 获取和分析关注者列表（“Mark Cuban 关注哪些类型的帐户？给我一份详细的报告”）
• 使用 LLM 撰写帖子，然后为您发布 😱（“写一首关于我所在地区今天天气的俳句，并将其发布到 bluesky”）
• 搜索动态消息、帖子和人物（“查找关于 #teslatakedown 的帖子，并给我一个关于最近事件的总结”）

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

• get-pinned-feeds: 返回已验证用户的首选项中所有“已置顶”的项目集。
• get-timeline-posts: 返回已验证用户的主页时间线中的帖子
• get-feed-posts: 返回指定动态消息中的帖子
• get-list-posts: 返回指定列表中的帖子
• get-user-posts: 返回指定用户的帖子
• get-profile: 返回指定用户的个人资料详细信息
• get-follows: 返回此用户关注的关注者集合
• get-liked-posts: 返回已验证用户最近喜欢的帖子
• get-trends: 返回 Bluesky 上当前的热门话题以及帖子数量
• search-posts: 返回给定查询的帖子。 可以指定热门或最新
• search-people: 返回给定搜索查询的人员
• search-feeds: 返回给定查询的动态消息
• like-post: 喜欢具有特定 URI 的帖子
• create-post: 发布帖子
• follow-user: 关注特定用户

安装

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

# 安装依赖项
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 for desktop 以连接到 Bluesky，请将以下 bluesky 部分添加到您的 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"
          }
      }
    }
  }

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

创建应用密码

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

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

安全注意事项

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

许可证

MIT