Bluesky MCP服务器

一个连接Bluesky的模型上下文协议服务器,提供与ATProtocol交互的工具,使LLM应用能够通过自然语言访问Bluesky功能。

  • by brianellin
  • TypeScript
  • 本地部署
  • 51 星标
  • 更新于
在 GitHub 查看 brianellin/bsky-mcp-server

使用说明

Bluesky MCP服务器

A. 模型上下文协议 连接到的服务器 蓝天 并提供与ATP协议交互的工具。

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

功能和工具

  • 通过自然语言与常见的Bluesky功能进行交互(例如“获取David Roberts的最新帖子”)
  • 获取并分析订阅源(“给我找一个关于西雅图的订阅源,告诉我人们在谈论什么”)
  • 获取并分析关注者列表(“Mark Cuban关注哪些类型的帐户?给我一份详细的报告”)
  • 使用法学硕士写一篇文章,然后为你发布😱 (“写一首关于我所在地区今天天气的俳句,并将其发布到bluesky”)
  • 搜索订阅源、帖子和人物(“查找有关#teslatakedown的帖子,并给我一个最近事件的摘要”)
  • 分析谁在跟踪你?(“谁在蓝天上跟踪我?给我一份报告”)

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

  • 获取固定订阅源:返回经过身份验证的用户首选项中所有“固定”项目的集合。
  • 获取时间线帖子:返回经过身份验证的用户的主页时间线中的帖子
  • 获取订阅源帖子:返回来自指定源的帖子
  • 获取列表帖子:返回指定列表中的帖子
  • 获取用户帖子:返回指定用户的帖子
  • 获取个人资料:返回指定用户的配置文件详细信息
  • 获取关注:返回帐户遵循的用户集
  • 获得追随者:返回关注某个帐户的用户集
  • 获得点赞帖子:返回经过身份验证的用户最近点赞的帖子
  • 了解趋势:返回Bluesky上的当前热门话题和帖子数
  • 获取帖子:返回特定帖子的完整对话线程,显示所有回复和上下文
  • 将url转换为uri:将Bluesky web URL转换为可与其他工具一起使用的AT URI格式
  • 搜索帖子:返回给定查询的帖子。可以指定top或latest
  • 搜索人员:返回给定搜索查询的人员
  • 搜索源:返回给定查询的提要
  • 喜欢post:类似于具有特定URI的帖子
  • 创建帖子:发布帖子
  • 关注用户:关注特定用户

提示:

  • 您可以按时间范围从搜索、时间线、列表、提要或个人资料中请求帖子。例如:总结我过去三天时间线上的帖子”或“给我找一篇人们本周谈论的最有趣的文章”
  • 变得奇怪:“在过去的24小时里,你在我的时间线上看到的最有趣/最疯狂/最奇怪/最愚蠢的帖子是什么?”
  • 了解自己:“分析我喜欢的帖子,告诉我我喜欢什么。给我3个有趣的事实,说明你在bluesky上发现了什么,以及它与我的个性有什么关系”或“谁在bluesky.com上关注我?给我一份全面的报告。”

安装

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的Bluesky MCP服务器 史密瑟里:

npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude

手动安装

首先克隆此仓库,然后安装依赖项并构建服务器:

# Install dependencies
pnpm install

# Build the project
pnpm run build

MCP检验员测试

您可以直接测试bluesky工具,而无需通过惊人的 MCP检查员。首先确保您已构建服务器,然后运行:

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

导航到终端中提供的本地URL,然后从左侧面板中设置BLUESKY_IDENTIFIER、BLUESKY_APP_PASSWORD和BLUESKY_SERVICE_URL环境变量。尝试使用获取时间线工具查看您家庭时间线中的最新帖子。

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 For desktop中运行MCP服务器的更多详细信息,请参阅https://modelcontextprotocol.io/quickstart/user

创建应用程序密码

要使用此MCP服务器,您需要为您的Bluesky帐户创建应用程序密码:

  1. 登录Bluesky
  2. 前往“设置”>“应用密码”
  3. 专门为此集成创建新的应用程序密码
  4. 使用BLUESKY_app_password环境变量设置应用程序密码

安全说明

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

许可证

麻省理工学院