Bluesky MCP Server

Bluesky MCP 服务

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

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

功能与工具

• 通过自然语言使用常见的 Bluesky 功能（例如：“获取 David Roberts 最近发布的帖子”）
• 获取并分析信息流（“帮我找一个关于西雅图的信息流，并告诉我大家都在讨论什么”）
• 获取并分析关注者列表（“Mark Cuban 关注的账号有哪些类型？请给我一份详细报告”）
• 使用大模型撰写帖子，然后替你发布 😱（“为我所在地区今天的天气写一首俳句，并发布到 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：关注指定用户

提示：

• 你可以按时间范围查询搜索结果、时间线、列表、信息流或个人资料中的帖子。例如：“总结过去 3 天我时间线上的帖子”或“帮我找出本周大家讨论得最热烈的文章”
• 尽管提问：“过去 24 小时里，你在我时间线上看到的最有趣／最离谱／最奇怪／最古怪的帖子是什么？”
• 了解自己：“分析我点赞过的帖子，告诉我感兴趣的内容。请分享关于你发现的内容的 3 个有趣事实，以及这些内容与我在 Bluesky 上的个性有什么关联。”或“谁在 Bluesky 上关注我？请给我一份全面的报告。”

安装

通过 Smithery 安装

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

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 工具，无需连接大模型。首先确保已构建服务，然后运行：

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. 前往 Settings > App Passwords
3. 专门为此集成创建一个新的应用密码
4. 使用 BLUESKY_APP_PASSWORD 环境变量设置应用密码

安全说明

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

许可证

MIT