Bluesky Context Server 使用说明

项目简介

Bluesky Context Server 是一个基于 Model Context Protocol (MCP) 构建的简单服务器，旨在为 LLM 客户端（如 Claude Desktop）提供访问 Bluesky 社交网络数据的能力。通过该服务器，LLM 可以调用预设的工具来获取 Bluesky 上的用户信息、帖子、关注者、粉丝等数据，从而扩展 LLM 的上下文信息来源，提升其在社交媒体相关任务中的表现。

主要功能点

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

安装步骤

下载代码: 从 GitHub 仓库 https://github.com/keturiosakys/bluesky-context-server 下载或克隆代码到你的计算机本地目录。
安装依赖 (可选，如果使用 Smithery 安装则跳过): 该项目使用 'bun' 作为运行时环境。请确保你已经安装了 'bun'。如果你没有安装 'bun'，可以访问 https://bun.sh/ 了解安装方法。
配置环境变量: 你需要设置以下环境变量用于 Bluesky API 的身份验证：
- 'BLUESKY_APP_KEY': 你的 Bluesky 应用密钥 (App Password)。
- 'BLUESKY_IDENTIFIER': 你的 Bluesky 用户名或邮箱地址。你可以在你的操作系统环境变量中或者在启动服务器的终端会话中设置这些环境变量。

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 Bluesky Context Server，你需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 客户端的 'config.json' 配置文件示例，你需要根据你的实际情况进行修改：

{
	"mcpServers": {
		"bluesky": {  // 服务器名称，可以自定义，例如 "bluesky"
			"command": "/path/to/bun",  // bun 的可执行文件路径，请替换为你的 bun 实际安装路径
			"args": [
				"/path/to/bluesky-context-server/index.ts" // index.ts 脚本的绝对路径，请替换为你代码存放的实际路径
			],
			"env": {
				// 环境变量可以在这里配置，也可以在系统环境变量中配置，推荐在系统环境变量中配置
				// "BLUESKY_APP_KEY": "YOUR_BLUESKY_APP_KEY",
				// "BLUESKY_IDENTIFIER": "YOUR_BLUESKY_IDENTIFIER"
			}
		}
	}
}

配置说明:

'"bluesky"': 是你为该 MCP 服务器自定义的名称，在 Claude Desktop 中引用该服务器时会用到这个名称。
'"command"': 指向 'bun' 运行时环境的可执行文件路径。你需要将其替换为你电脑上 'bun' 的实际安装路径。例如，在 macOS 上，如果使用 'bun install' 安装，路径可能类似于 '/Users/用户名/.bun/bin/bun'。你可以使用 'which bun' 命令来查找 bun 的路径。
'"args"': 是一个字符串数组，包含了启动服务器脚本所需的参数。
- 数组的第一个元素是 'index.ts' 脚本的绝对路径。你需要将其替换为你下载的 'bluesky-context-server' 目录中 'index.ts' 文件的完整路径。
'"env"': 是一个对象，用于设置服务器运行时需要的环境变量。
- 'BLUESKY_APP_KEY' 和 'BLUESKY_IDENTIFIER' 是连接 Bluesky API 所需的凭据。 强烈建议将这些敏感信息设置为系统级别的环境变量，而不是直接写在配置文件中。 如果选择在此处配置，请取消注释并替换为你的实际 Bluesky 应用密钥和用户名/邮箱。

重要提示: 请务必将 '/path/to/bun' 和 '/path/to/bluesky-context-server/index.ts' 替换为你电脑上 'bun' 可执行文件和 'index.ts' 脚本的实际路径。

基本使用方法

启动服务器: 配置完成后，当 Claude Desktop 启动时，或者当你手动启动配置的 MCP 服务器时，Bluesky Context Server 将会在后台运行。由于该服务器使用 'stdio' 作为传输协议，它会在标准输入/输出流中与客户端进行通信。
在 Claude Desktop 中使用: 在 Claude Desktop 中，你可以通过在 Prompt 中提及工具名称来调用 Bluesky Context Server 提供的功能。例如，你可以这样提问：

'请使用 bluesky_get_profile 工具查询我的 Bluesky 个人资料。'

或者

'使用 bluesky_search_posts 工具搜索关于 "人工智能" 的帖子。'

Claude Desktop 会识别 'bluesky_get_profile' 和 'bluesky_search_posts' 等工具名称，并将请求转发给 Bluesky Context Server 处理，然后将结果返回给你。

注意: 工具的具体使用方式和参数需要参考 'index.ts' 文件中定义的 'Tool' 对象的 'inputSchema' 属性。 Claude Desktop 等 MCP 客户端通常会根据这些 Schema 帮助用户构建正确的工具调用请求。

关键词