Bluesky Context Server 使用说明

项目简介

Bluesky Context Server 是一个基于 Model Context Protocol (MCP) 标准构建的后端服务器，旨在为大型语言模型 (LLM) 提供访问 Bluesky 社交网络数据的能力。通过此服务器，LLM 客户端可以调用预定义的工具来查询 Bluesky 上的用户信息、帖子、关注者等信息，从而扩展 LLM 的上下文理解和应用场景。

主要功能点

用户信息查询: 获取指定用户的个人资料信息。
帖子查询: 获取用户的最新帖子、搜索帖子，以及获取用户点赞的帖子。
关注关系查询: 获取用户的关注列表和粉丝列表。
个人 Feed 查询: 获取用户个性化的 Bluesky 时间线。
用户搜索: 根据关键词搜索 Bluesky 用户。

以上功能均通过预定义的 工具 (Tools) 暴露给 MCP 客户端，客户端可以根据需要调用这些工具获取 Bluesky 数据。

安装步骤

方法一：通过 Smithery 自动安装 (推荐 Claude Desktop 用户)

如果您使用 Claude Desktop 客户端，可以通过 Smithery 命令行工具自动安装 Bluesky Context Server。

确保您已安装 Node.js 和 npm (或 bun)。
打开终端，运行以下命令：

npx -y @smithery/cli install @laulauland/bluesky-context-server --client claude

方法二：手动安装

下载代码: 将仓库代码克隆或下载到您的计算机本地目录。
安装依赖: 在代码根目录下，使用 bun 安装项目依赖（如果使用 npm，请将 'bun install' 替换为 'npm install'）：

bun install

配置环境变量: Bluesky Context Server 需要 Bluesky 应用密钥 (BLUESKY_APP_KEY) 和用户标识符 (BLUESKY_IDENTIFIER) 进行身份验证。您需要设置以下环境变量：
- 'BLUESKY_APP_KEY': 您的 Bluesky 应用密钥。
- 'BLUESKY_IDENTIFIER': 您的 Bluesky 用户标识符 (例如邮箱或句柄)。
您可以通过多种方式设置环境变量，例如在 '.env' 文件中设置，或者直接在终端中 export。

服务器配置

MCP 客户端 (例如 Claude Desktop) 需要配置 MCP 服务器的启动命令才能连接到 Bluesky Context Server。以下是 Claude Desktop 客户端的 'config.json' 配置文件示例，展示了如何配置 Bluesky Context Server。

{
	"mcpServers": {
		"bluesky": {  // 服务器名称，可以自定义
			"command": "/Users/laurynas-fp/.bun/bin/bun",  // 启动服务器的命令，这里假设 bun 可执行文件在 /Users/laurynas-fp/.bun/bin/bun 路径下，请根据您的实际 bun 安装路径进行调整。如果使用 npm，则命令可能是 "node" 或 "npm start"
			"args": [
				"<代码目录>/bluesky-context-server/index.ts" // 服务器入口文件路径，请将 "<代码目录>" 替换为您实际的代码存放路径
			],
			"env": {  // 环境变量配置
				"BLUESKY_APP_KEY": "YOUR_BLUESKY_APP_KEY",  // 您的 Bluesky 应用密钥，请替换为您的实际密钥
				"BLUESKY_IDENTIFIER": "YOUR_BLUESKY_IDENTIFIER" // 您的 Bluesky 用户标识符，请替换为您的实际标识符
			}
		}
	}
}

配置说明:

'"bluesky"': 服务器名称，您可以在客户端配置中引用此名称。
'"command"': 启动服务器的命令。示例中使用 'bun' 运行 'index.ts' 文件。如果您使用 npm 或其他方式启动，请修改此命令。
'"args"': 传递给启动命令的参数。这里指定了服务器入口文件 'index.ts' 的路径。请根据您的代码存放位置修改路径。
'"env"': 环境变量配置。'BLUESKY_APP_KEY' 和 'BLUESKY_IDENTIFIER' 是 Bluesky Context Server 运行必需的环境变量，请务必替换为您的实际值。

请注意:

请根据您的实际 Bun 安装路径、代码存放路径以及 Bluesky 账户信息，修改上述配置信息。
如果您不使用 Claude Desktop，请参考您使用的 MCP 客户端的文档，了解如何配置 MCP 服务器连接。

基本使用方法

启动服务器: 在配置完成后，您需要先启动 Bluesky Context Server。在代码根目录下，运行以下命令 (假设使用 bun)：
```
bun index.ts
```
如果一切配置正确，您应该看到 "Starting Bluesky MCP Server..." 和 "Bluesky MCP Server running on stdio" 等日志信息，表示服务器已成功启动。
配置 MCP 客户端: 根据您使用的 MCP 客户端 (例如 Claude Desktop) 的文档，配置连接到名为 "bluesky" 的 MCP 服务器。
在客户端中使用工具: 在客户端中，您可以使用以下工具名称来调用 Bluesky Context Server 提供的功能：
- 'bluesky_get_profile' (获取用户信息)
- 'bluesky_get_posts' (获取用户帖子)
- 'bluesky_search_posts' (搜索帖子)
- 'bluesky_get_follows' (获取关注列表)
- 'bluesky_get_followers' (获取粉丝列表)
- 'bluesky_get_liked_posts' (获取点赞帖子)
- 'bluesky_get_personal_feed' (获取个人 Feed)
- 'bluesky_search_profiles' (搜索用户)
具体的工具调用方式和参数，请参考 MCP 客户端的使用说明。

通过以上步骤，您就可以成功安装、配置和使用 Bluesky Context Server，为您的 LLM 应用提供访问 Bluesky 数据的能力。

关键词