Bluesky MCP Server

Bluesky MCP Server

site icon
2025.04.04 0
JavaScript社交平台自然语言交互交流协作
Bluesky MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,用于连接 Bluesky 社交平台,并提供与 ATProtocol 交互的工具。通过该服务器,用户可以将 Bluesky 的各种 API 端点直接集成到基于 LLM 的应用程序中,实现自然语言交互。例如,用户可以通过自然语言指令获取帖子、分析动态、搜索内容,甚至发布帖子。
View on GitHub

Overview

基本能力

产品定位

Bluesky MCP Server 是一个用于 Bluesky 社交平台的 MCP 服务器,旨在通过自然语言交互简化用户与 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/brianellin/bsky-mcp-server.git

# 安装依赖
pnpm install

# 构建项目
pnpm run build

调试方式

  1. 使用 MCP Inspector 测试工具:
npx @modelcontextprotocol/inspector node build/src/index.js
  1. 在浏览器中访问终端提供的本地 URL。
  2. 设置环境变量 BLUESKY_IDENTIFIERBLUESKY_APP_PASSWORDBLUESKY_SERVICE_URL
  3. 尝试使用 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. 登录 Bluesky。
  2. 进入 Settings > App Passwords。
  3. 为该集成创建一个新的应用密码。
  4. 使用 BLUESKY_APP_PASSWORD 环境变量设置应用密码。

许可证

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