Bluesky MCP 服务器使用说明

项目简介

本Bluesky MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将 Bluesky 社交网络平台的功能集成到大型语言模型 (LLM) 应用中。通过本服务器，LLM 应用可以获取用户的 Bluesky 时间线、用户资料、帖子内容、趋势话题等信息，并能执行发布帖子、点赞、关注用户等操作，从而实现更智能、更自然的社交互动体验。

主要功能点

丰富的Bluesky数据访问工具: 提供多种工具，例如：
- 获取用户时间线帖子
- 获取指定Feed或列表的帖子
- 获取用户个人资料和关注列表
- 搜索帖子、用户和Feed
- 获取用户点赞的帖子
- 获取Bluesky趋势话题
Bluesky社交互动工具: 支持LLM应用调用工具执行社交操作，例如：
- 发布新帖子
- 点赞帖子
- 关注用户
可扩展的资源: 内置了 Bluesky 平台信息和帖子结构文档资源，方便LLM理解和利用 Bluesky 数据。

安装步骤

克隆仓库

git clone https://github.com/brianellin/bsky-mcp-server.git
cd bsky-mcp-server

安装依赖
```
pnpm install
```
构建项目
```
pnpm run build
```

服务器配置

要将本MCP服务器连接到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加服务器配置信息。以下是一个 'claude_desktop_config.json' Bluesky 服务器配置示例：

{
  "mcpServers": {
    "bluesky": {  // 服务器名称，可以自定义
      "command": "node",  // 启动服务器的命令，这里使用 node.js 运行时
      "args": ["/path/to/bsky-mcp-server/build/src/index.js"], // 服务器启动脚本的路径，请替换为实际路径
      "env": { // 环境变量配置
        "BLUESKY_IDENTIFIER": "your-bluesky-handle", // 您的 Bluesky 用户名或邮箱
        "BLUESKY_APP_PASSWORD": "your-app-password", // 您在 Bluesky 设置中创建的应用密码
        "BLUESKY_SERVICE_URL": "https://bsky.social" // Bluesky 服务地址，通常为默认地址
      }
    }
  }
}

请注意:

'/path/to/bsky-mcp-server/build/src/index.js' 需要替换为 实际的 'index.js' 文件路径。
'BLUESKY_IDENTIFIER' 和 'BLUESKY_APP_PASSWORD' 需要替换为您 真实的 Bluesky 账户信息。
您需要在 Bluesky 账户设置中创建 应用密码，并将该密码配置到 'BLUESKY_APP_PASSWORD' 环境变量中。

基本使用方法

启动服务器: MCP 服务器会在客户端连接时自动启动，无需手动运行。
配置 MCP 客户端: 根据您的 MCP 客户端 (如 Claude Desktop) 的文档，配置上述服务器信息。
在 LLM 应用中使用: 在您的 LLM 应用中，您可以自然语言指令调用本服务器提供的工具，例如：
- "获取我的 Bluesky 时间线上的最新帖子" (对应 'get-timeline-posts' 工具)
- "查找关于 #OpenAI 的帖子" (对应 'search-posts' 工具)
- "给我马克·库班的个人资料" (对应 'get-profile' 工具)
- "写一个关于今天天气的俳句并发布到 Bluesky" (对应 'create-post' 工具)

您可以使用 MCP Inspector 工具来测试和探索本服务器提供的工具，无需连接到 LLM 客户端。运行命令 'npx @modelcontextprotocol/inspector node build/src/index.js' 即可启动 MCP Inspector 并连接到本服务器。

关键词