使用说明

项目简介

Bluesky Context Server 是一个基于 Model Context Protocol (MCP) 实现的服务器，它作为一个桥梁，连接 MCP 客户端和 Bluesky 社交网络。通过该服务器，LLM 应用 (MCP 客户端) 可以利用预定义的工具，安全、便捷地获取 Bluesky 平台上的公开数据，例如用户个人资料、帖子内容、关注列表等，从而增强 LLM 应用对社交媒体信息的理解和利用能力。

主要功能点

Bluesky 数据访问: 提供多种工具，允许 MCP 客户端查询 Bluesky 社交网络上的数据。
- 获取用户资料: 查询指定用户的基本信息。
- 获取用户帖子: 检索用户的最新帖子。
- 搜索帖子: 根据关键词在 Bluesky 上搜索帖子。
- 获取关注列表: 获取用户关注的账号列表。
- 获取粉丝列表: 获取关注用户的账号列表。
- 获取点赞帖子: 获取用户点赞过的帖子。
- 获取个人动态: 获取用户的个性化 Bluesky 动态。
- 搜索用户资料: 根据关键词搜索 Bluesky 用户。

安装步骤

下载代码: 从 GitHub 仓库 https://github.com/MCP-Mirror/keturiosakys_bluesky-context-server 下载或克隆代码到本地计算机。
安装 Bun (如果尚未安装): 该项目使用 Bun 运行时环境。如果你的计算机上没有安装 Bun，请根据 https://bun.sh/ 上的指引进行安装。
设置环境变量: 需要设置 Bluesky API 密钥和身份标识符作为环境变量。
- 'BLUESKY_APP_KEY': 你的 Bluesky 应用密钥。
- 'BLUESKY_IDENTIFIER': 你的 Bluesky 身份标识符 (例如邮箱或用户名)。请将你的 Bluesky API 密钥和身份标识符设置为操作系统的环境变量。具体设置方法取决于你使用的操作系统。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端 (例如 Claude Desktop 应用)，你需要提供以下 JSON 配置信息。请注意， '<path_to_this_directory>' 需要替换为 'bluesky-context-server' 文件夹在你电脑上的实际路径。

{
  "mcpServers": {
    "bluesky": {
      "command": "/Users/laurynas-fp/.bun/bin/bun",  // Bun 运行时的命令路径 (请根据你的 Bun 安装路径调整)
      "args": [
        "<path_to_this_directory>/bluesky-context-server/index.ts" // index.ts 脚本的路径 (请替换为实际路径)
      ],
      "env": {
        "BLUESKY_APP_KEY": "",     // Bluesky API 密钥 (请在环境变量中设置，此处无需填写)
        "BLUESKY_IDENTIFIER": ""    // Bluesky 身份标识符 (请在环境变量中设置，此处无需填写)
      }
    }
  }
}

重要说明:

请确保 'command' 指向你计算机上 Bun 运行时的正确路径。你可以通过在终端输入 'which bun' 或 'where bun' (取决于你的操作系统) 来查找 Bun 的路径。
'<path_to_this_directory>' 必须替换为 'bluesky-context-server' 文件夹在你本地文件系统中的绝对路径。
建议将 'BLUESKY_APP_KEY' 和 'BLUESKY_IDENTIFIER' 设置为系统环境变量，而不是直接写在配置文件中，以提高安全性。

基本使用方法

启动 Bluesky Context Server：在终端中，进入 'bluesky-context-server' 目录，并运行命令 'bun index.ts'。服务器成功启动后，会在终端输出 "Bluesky MCP Server running on stdio" 等信息。
配置 MCP 客户端：将上述 服务器配置 JSON 代码添加到你的 MCP 客户端的配置文件中 (例如 Claude Desktop 应用的 'config.json' 文件)。
使用 MCP 客户端与 Bluesky 互动：现在，你的 MCP 客户端应该能够连接到 Bluesky Context Server。你可以通过客户端提供的界面或指令，调用服务器提供的工具来查询 Bluesky 数据。具体的工具调用方式和参数，请参考 MCP 客户端的文档和工具的描述信息。

例如，在 Claude 中，你可以指示 Claude 使用 "bluesky_get_posts" 工具来获取某个用户的最新帖子。

关键词