Bluesky社交网络MCP服务器

Bluesky社交网络的MCP(Model Context Protocol)服务器,支持浏览时间线、管理帖子、搜索和用户互动等功能。

  • by joeswann
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 joeswann/bluesky-mcp

使用说明

Bluesky MCP服务器

Bluesky社交网络(ATProto)的MCP(模型上下文协议)服务器。使Claude Desktop、Claude Code和其他MCP客户端能够在Bluesky上浏览时间线、管理帖子、搜索和与用户交互。

特性

  • 时间线和订阅源:浏览主页时间线和用户提要
  • 岗位管理:创建、删除、转发、喜欢和不喜欢的帖子
  • 搜索:全文搜索帖子和用户
  • 社交图谱:关注/取消关注用户、查看关注者和关注
  • 通知:阅读Bluesky通知
  • 档案:查看用户资料和帖子

安装

先决条件

  • Node.js>=18.0.0

源自源头

  1. 克隆此仓库
  2. 安装依赖项:
    npm install
    
  3. 构建项目:
    npm run build
    

配置

环境变量

变量 必填 默认 描述
BLUESKY_IDENTIFIER 是 -- 你的Bluesky手柄或DID
BLUESKY_APP_PASSWORD 是 -- 应用程序密码(不是您的帐户密码)
BLUESKY_PDS_URL 没有 https://bsky.social 自定义PDS端点

创建一个 .env 在shell环境中文件或设置这些。

要生成应用程序密码:Bluesky设置>高级>应用程序密码。

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "bluesky": {
      "command": "node",
      "args": ["/path/to/bluesky-mcp/build/index.js"],
      "env": {
        "BLUESKY_IDENTIFIER": "your.handle.bsky.social",
        "BLUESKY_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

使用Claude代码

claude mcp add bluesky -- node /path/to/bluesky-mcp/build/index.js

可用工具

工具 说明
whoami 获取经过身份验证的用户信息
timeline 浏览主页时间线
get_user_feed 获取特定用户的帖子
get_profile 查看用户的个人资料
get_post_thread 查看帖子及其回复
create_post 创建新帖子
delete_post 删除帖子
repost 转发帖子
like_post 喜欢帖子
unlike_post 与帖子不同
search_posts 搜索帖子
search_users 搜索用户
get_notifications 查看通知
follow_user 关注用户
unfollow_user 关注用户
get_followers 列出用户的关注者
get_follows 列出用户关注的人

发展

  • npm run dev --带有TypeScript编译的监视模式
  • npm run build --构建项目
  • npm start --启动内置服务器

许可证

麻省理工学院