AI导哈

Bluesky上下文服务器

一个模型上下文协议（MCP）服务器，使MCP客户端如Claude Desktop能够与Bluesky交互，查询个人资料、搜索帖子、获取时间线等。

  • by laulauland
  • TypeScript
  • 本地部署
  • 35 星标
  • 更新于
在 GitHub 查看 laulauland/bluesky-context-server

使用说明

Bluesky上下文服务器

一个模型上下文协议（MCP）服务器，使Claude Desktop等MCP客户端能够与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安装（推荐）

通过以下方式自动安装Bluesky Context Server for 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"
			}
		}
	}
}
  1. 重新启动克劳德桌面

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上搜索有关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的日志以获取错误消息

相关 MCP