项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器端应用，旨在允许兼容 MCP 的大语言模型 (LLM) 客户端与 Bluesky 社交网络进行交互。它充当 LLM 和 Bluesky 之间的桥梁，使 LLM 能够代表用户执行操作和获取信息。

主要功能点

该服务器通过提供一系列工具，使 LLM 能够执行以下与 Bluesky 相关的任务：

• 账户认证： 使用您的 Bluesky 凭据登录账户。服务器启动时支持自动登录，也可通过工具手动登录。
• 内容发布： 创建并发布包含文本和可选图片的帖子（推文）。
• 信息获取： 获取您的个人资料信息、查看您的主页时间线或根据 URI 获取特定的一个或多个帖子。
• 社交互动： 对帖子进行点赞、取消点赞、转发（repost）或取消转发。
• 内容管理： 删除您自己发布的帖子。
• 时间线格式化： 服务器包含一个功能，可以将获取到的原始时间线数据格式化成更易于 LLM 理解和总结的结构。

安装步骤

1. 确保您的系统已安装 Node.js 和配套的 npm 包管理器。
2. 通过 Git 克隆该仓库代码，或者下载并解压源代码包。
3. 在项目根目录打开终端，运行以下命令安装项目依赖：

   npm install
   

4. 运行以下命令构建项目：

   npm run build
   

完成这些步骤后，服务器的可执行文件已准备就绪。

服务器配置

MCP 服务器通常由 MCP 客户端应用程序（例如支持 MCP 的 LLM 客户端）启动和管理。您需要在客户端的配置中添加关于 Bluesky MCP 服务器的信息。配置通常以 JSON 格式提供，需要指定：

• 一个唯一的 服务器名称 (server name)，例如 'bluesky-mcp'。
• 启动服务器的 命令 (command)，例如 'npx'（用于直接执行 npm 包）。
• 传递给启动命令的 参数 (args)，例如 '-y @semihberkay/bluesky-mcp'。
• 服务器运行所需的 环境变量 (env)，这是传递 Bluesky 登录凭据的关键。请在此处设置 'BLUESKY_IDENTIFIER'（您的 Bluesky 句柄或邮箱）和 'BLUESKY_PASSWORD'（您的 Bluesky 应用密码）。这些环境变量将由客户端在启动服务器进程时提供。

配置完成后，客户端即可通过标准输入/输出（Stdio）协议与此 MCP 服务器通信。服务器启动时会尝试使用环境变量自动登录，如果失败或未设置环境变量，您需要在与 LLM 交互时提示它使用登录工具进行认证。

基本使用方法

当 Bluesky MCP 服务器在您的 MCP 客户端环境中配置并成功运行后，您的 LLM 将拥有与 Bluesky 交互的能力。您可以通过自然语言向 LLM 发出指令，例如：

• “请帮我发布一条 Bluesky 推文，内容是：[你想发布的内容]”
• “获取我最新的 Bluesky 时间线并总结一下。”
• “点赞这个 Bluesky 帖子：[帖子链接]”
• “我的 Bluesky 个人资料是什么样的？”

LLM 会根据您的指令，识别需要调用的 Bluesky MCP 服务器工具，并使用相应的参数执行操作。请注意，首次使用或当自动登录失败时，您可能需要明确指示 LLM 执行登录操作。