Bluesky MCP Server

基本能力

产品定位

Bluesky MCP Server 是一个桥梁工具，将 Bluesky 社交平台的功能通过自然语言接口暴露给 LLM 应用程序，使用户能够以更直观的方式与 Bluesky 交互。

核心功能

• 通过自然语言与 Bluesky 交互（如获取用户最近的帖子）。
• 获取并分析动态（如查找关于某个主题的动态并总结讨论内容）。
• 获取并分析关注列表（如分析某个用户关注的账户类型）。
• 使用 LLM 生成帖子并发布（如生成一首关于当天天气的俳句并发布）。
• 搜索动态、用户和主题（如搜索关于某个话题的帖子并总结近期事件）。

适用场景

• 自然语言驱动的 Bluesky 客户端。
• 自动化内容生成和发布。
• 社交动态分析和报告生成。
• 用户行为分析和趋势跟踪。

工具列表

• 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: 关注指定用户。

常见问题解答

• 安全性: 服务器仅将会话信息存储在内存中，不会与 MCP 客户端共享。
• 认证: MCP 客户端只能访问工具，无法访问用户的认证信息或应用密码。

使用教程

使用依赖

1. 确保已安装 Node.js 和 pnpm。

安装教程

# 克隆仓库
git clone https://github.com/your-repo/bsky-mcp-server.git

# 安装依赖
pnpm install

# 构建项目
pnpm run build

调试方式

1. 使用 MCP Inspector 测试工具：

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

1. 在浏览器中打开提供的本地 URL，并设置以下环境变量：
2. BLUESKY_IDENTIFIER: 你的 Bluesky 用户名。
3. BLUESKY_APP_PASSWORD: 你的应用密码。
4. BLUESKY_SERVICE_URL: Bluesky 服务 URL（默认为 https://bsky.social）。
5. 使用 get-timeline 工具测试获取主页时间线的帖子。

MCP 客户端配置

1. 编辑 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"
          }
      }
    }
  }

1. 更多详情请参考 MCP 快速入门指南。

创建应用密码

1. 登录 Bluesky。
2. 进入设置 > 应用密码。
3. 为该集成创建一个新的应用密码。
4. 使用 BLUESKY_APP_PASSWORD 环境变量设置应用密码。

许可证

该项目遵循 MIT 开源许可条款。