Bluesky Context Server

这是一个模型上下文协议（MCP）服务器，使像Claude Desktop这样的MCP客户端能够与Bluesky进行交互。查询您的个人资料、搜索帖子、获取您的时间线等，都可以直接通过您的AI助手完成。

预备条件

• 运行时：Bun 或 Node.js v22.6.0+
• 一个Bluesky账户

设置

1. 获取您的Bluesky凭证

您需要从您的Bluesky账户中获取以下两部分信息：

BLUESKY_IDENTIFIER

这是您的Bluesky用户名。它可以是以下两种格式之一：

• username.bsky.social（例如，alice.bsky.social）
• @username.bsky.social（例如，@alice.bsky.social）

BLUESKY_APP_KEY

这是一个应用密码，不同于您的常规Bluesky密码。要创建一个：

1. 前往 Bluesky设置
2. 导航到“隐私和安全”→“应用密码”
3. 点击“添加应用密码”
4. 给它命名（例如，“MCP服务器”）
5. 复制生成的密码（看起来像 xxxx-xxxx-xxxx-xxxx）

⚠️ 重要：使用应用密码，而不是您的常规账户密码！

2. 安装

方案A：通过Smithery安装（推荐）

要通过Smithery自动安装Bluesky Context Server以供Claude Desktop使用：

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

然后将您的凭证添加到生成的配置中。

方案B：手动安装

1. 克隆或下载此仓库
2. 配置您的Claude Desktop应用程序以使用MCP服务器：

使用Bun：

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "/Users/your-username/.bun/bin/bun",
			"args": [
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

使用Node.js：

// ~/Library/Application Support/Claude/config.json (macOS)
// %APPDATA%/Claude/config.json (Windows)
{
	"mcpServers": {
		"bluesky": {
			"command": "node",
			"args": [
				"--experimental-strip-types",
				"/path/to/bluesky-context-server/packages/server/bin/index.ts"
			],
			"env": {
				"BLUESKY_APP_KEY": "your-app-password-here",
				"BLUESKY_IDENTIFIER": "your-handle.bsky.social"
			}
		}
	}
}

3. 重启Claude Desktop

3. 测试连接

设置完成后，您可以通过询问Claude一些问题来测试连接：

• “你能获取我的Bluesky个人资料吗？”
• “展示我最近在Bluesky上的帖子”
• “在Bluesky上搜索关于AI的帖子”

可用的MCP工具

此服务器提供以下Claude可以使用的工具：

个人资料及账户工具

bluesky_get_profile

获取您的Bluesky个人资料信息，包括显示名称、简介、关注者数量等。

• 参数：无
• 返回值：完整的个人资料数据

bluesky_get_follows

获取您关注的账户列表。

• 参数：
  • limit（可选）：返回的最大项目数（默认50，最大100）
  • cursor（可选）：下一页的分页游标
• 返回值：带有个人资料信息的关注账户列表

bluesky_get_followers

获取关注您的账户列表。

• 参数：
  • limit（可选）：返回的最大项目数（默认50，最大100）
  • cursor（可选）：下一页的分页游标
• 返回值：带有个人资料信息的关注者列表

帖子及动态工具

bluesky_get_posts

获取您的最近帖子。

• 参数：
  • limit（可选）：返回的最大项目数（默认50，最大100）
  • cursor（可选）：下一页的分页游标
• 返回值：带有互动数据的最近帖子

bluesky_get_personal_feed

获取您的个性化Bluesky时间线/动态。

• 参数：
  • limit（可选）：返回的最大项目数（默认50，最大100）
  • cursor（可选）：下一页的分页游标
• 返回值：来自您个性化动态的帖子

bluesky_get_liked_posts

获取您喜欢的帖子。

• 参数：
  • limit（可选）：返回的最大项目数（默认50，最大100）
  • cursor（可选）：下一页的分页游标
• 返回值：您喜欢的帖子

搜索工具

bluesky_search_posts

在Bluesky上搜索帖子。

• 参数：
  • query（必需）：搜索查询字符串
  • limit（可选）：返回的最大项目数（默认50，最大100）
  • cursor（可选）：下一页的分页游标
• 返回值：匹配您的搜索查询的帖子

bluesky_search_profiles

搜索Bluesky用户个人资料。

• 参数：
  • query（必需）：搜索查询字符串
  • limit（可选）：返回的最大项目数（默认50，最大100）
  • cursor（可选）：下一页的分页游标
• 返回值：匹配您的搜索查询的用户个人资料

示例用法

一旦配置好，您可以向Claude提出如下问题：

• “今天我的Bluesky动态里有什么？”
• “在Bluesky上搜索关于TypeScript的帖子”
• “最近谁关注了我？”
• “展示我最近喜欢的帖子”
• “找到对AI感兴趣的Bluesky用户”

故障排除

常见问题

1. “身份验证失败”：请再次检查您的BLUESKY_APP_KEY和BLUESKY_IDENTIFIER
2. “服务器未响应”：确保已安装Bun且服务器路径正确
3. “权限被拒绝”：确保服务器文件具有执行权限

获取帮助

如果您遇到问题：

1. 检查您的Bluesky凭证是否正确
2. 验证Bun是否已安装：bun --version
3. 手动测试服务器：cd packages/server && bun start
4. 查看Claude Desktop的日志以获取错误消息