# Bluesky MCP 服务器
## 基本信息
- Slug: `brianellin-bsky-mcp-server`
- Source: modelscope
- Publisher: @brianellin/bsky-mcp-server
- Categories: social-media / communication
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@brianellin/bsky-mcp-server
## 简介
一种模型上下文协议服务器，使AI助手能够与Bluesky/ATProtocol进行交互，提供身份验证、时间线访问、帖子创建以及点赞和关注等社交功能。
## 安装提示

```bash
npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude
```

## MCP Server 详情

# Bluesky MCP 服务器

[![smithery 徽章](https://smithery.ai/badge/@brianellin/bsky-mcp-server)](https://smithery.ai/server/@brianellin/bsky-mcp-server)

这是一个 [模型上下文协议](https://modelcontextprotocol.io/) 服务器，它连接到 [Bluesky](https://bsky.app/) 并提供与 AT 协议交互的工具。

你可以使用这个 MCP 服务器将来自各种 Bluesky / AT 协议 API 端点的上下文直接带入基于 LLM 的应用程序的上下文窗口中。例如，你可以将此服务器添加到 Claude Desktop 中，然后将其用作自然语言的 Bluesky 客户端。

## 功能与工具

- 通过自然语言与常见的 Bluesky 功能进行交互（例如：“获取 David Roberts 最近的帖子”）
- 获取并分析动态（“找到关于西雅图的动态并告诉我人们在谈论什么”）
- 获取并分析关注者列表（“Mark Cuban 关注的是哪些类型的账户？给我一个详细的报告”）
- 使用 LLM 为你写一篇帖子并发布 😱（“为我所在地区的今日天气写一首俳句，并发布到 Bluesky 上”）
- 搜索动态、帖子和人物（“找到关于 #teslatakedown 的帖子并给我一份最近事件的摘要”）
- 分析谁在关注你？（“谁在 Bluesky 上关注我？给我一份报告”）

以下是当前提供的工具列表：

- **get-pinned-feeds**：返回已认证用户偏好设置中的所有“固定”项目。
- **get-timeline-posts**：返回已认证用户主页时间线上的帖子。
- **get-feed-posts**：返回指定动态中的帖子。
- **get-list-posts**：返回指定列表中的帖子。
- **get-user-posts**：返回指定用户的帖子。
- **get-profile**：返回指定用户的个人资料详情。
- **get-follows**：返回一个账户所关注的用户集合。
- **get-followers**：返回关注一个账户的用户集合。
- **get-liked-posts**：返回已认证用户最近喜欢的帖子。
- **get-trends**：返回 Bluesky 上当前的趋势话题及其帖子数量。
- **get-post-thread**：返回特定帖子的完整对话线程，显示所有回复和上下文。
- **convert-url-to-uri**：将 Bluesky 网页 URL 转换为可以与其他工具一起使用的 AT URI 格式。
- **search-posts**：返回给定查询的帖子。可以指定最热门或最新。
- **search-people**：返回给定搜索查询的人物。
- **search-feeds**：返回给定查询的动态。
- **like-post**：点赞具有特定 URI 的帖子。
- **create-post**：发布一条帖子。
- **follow-user**：关注特定用户。

提示：

- 您可以根据时间范围从搜索、时间线、列表、动态或个人资料中请求帖子。例如：“总结我过去三天的时间线上的帖子” 或 “找到本周人们谈论的最有趣的文章”
- 寻找奇特内容：“在我过去24小时的时间线上，你见过最搞笑/最失控/最奇怪/最滑稽的帖子是什么？”
- 了解自己：“分析我喜欢的帖子并告诉我我对什么感兴趣。给我3个关于你的发现的有趣事实以及它们如何与我在Bluesky上的个性相关联。” 或 “谁在Bluesky上关注了我？给我一个全面的报告。”

## 安装

### 通过Smithery安装

要通过[Smithery](https://smithery.ai/server/@brianellin/bsky-mcp-server)自动安装适用于Claude Desktop的Bluesky MCP服务器，请运行：

```bash
npx -y @smithery/cli install @brianellin/bsky-mcp-server --client claude
```


### 手动安装
首先克隆此仓库，然后安装依赖项并构建服务器：

```bash
# Install dependencies
pnpm install

# Build the project
pnpm run build
```


### 使用MCP Inspector测试

您可以直接使用出色的[MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector)来测试Bluesky工具，而无需连接到LLM。首先确保您已经构建了服务器，然后运行：

```bash
npx @modelcontextprotocol/inspector node build/src/index.js
```


导航到终端中提供的本地URL，然后从左侧面板设置您的BLUESKY_IDENTIFIER、BLUESKY_APP_PASSWORD和BLUESKY_SERVICE_URL环境变量。尝试使用get-timeline工具查看来自您主页时间线的最新帖子。

## MCP客户端配置

按照步骤使用您选择的客户端设置MCP。例如，要将Claude桌面版连接到Bluesky，请在claude_desktop_config.json中的bluesky部分添加以下内容：

```json
{
    "mcpServers": {
      "bluesky": {
        "command": "node",
        "args": ["/path/to/bsky-mcp-server/build/src/index.js"],
        "env": {
            "BLUESKY_IDENTIFIER": "your-bluesky-handle",
            "BLUESKY_APP_PASSWORD": "your-app-password",
            "BLUESKY_SERVICE_URL": "https://bsky.social"
          }
      }
    }
  }
```


有关在Claude桌面版中运行MCP服务器的更多详细信息，请参阅[https://modelcontextprotocol.io/quickstart/user](https://modelcontextprotocol.io/quickstart/user)


## 创建应用密码

要使用此MCP服务器，您需要为您的Bluesky帐户创建一个应用密码：
1. 登录Bluesky
2. 转到设置 > 应用密码
3. 为此集成专门创建一个新的应用密码
4. 使用BLUESKY_APP_PASSWORD环境变量设置该应用密码

## 安全注意事项

- 该服务器仅在内存中存储您的会话信息，并不会与MCP客户端共享。
- MCP客户端只能访问工具，不能访问您的身份验证或应用密码

## 许可证

MIT