JinDaGe - brianellin_bsky-mcp-server MCP Details

article

README

🚀 蓝天下MCP服务器

这是一个 Model Context Protocol 服务器，它连接到蓝天下并提供与 AT 协议交互的工具。你可以将此 MCP 服务器集成到基于大语言模型（LLM）的应用程序中，直接从蓝天下 / AT 协议 API 端点获取上下文信息。例如，你可以在 Claude 桌面版中添加此服务器，将其作为自然语言的蓝天下客户端使用。

🚀 快速开始

你可以将此 MCP 服务器集成到你的 LLM 基础应用程序中，直接从 Bluesky / ATProtocol API 端点获取上下文信息。例如，在 Claude Desktop 中添加此服务器，就能将它作为自然语言的 Bluesky 客户端。

✨ 主要特性

交互特性

通过自然语言与常见的蓝天下功能交互（例如 "获取 David Roberts 的近期帖子"）
检索并分析信息流（"找到关于西雅图的信息流并告诉我人们在讨论什么”）
检索和分析关注者列表（“Mark Cuban 关注了哪些类型的账户？给我一个详细的报告”）
使用大语言模型编写一条帖子，然后自动发布 😱（“为今天的天气写一首俳句并发布到蓝天下上”）
搜索信息流、帖子和用户（“查找有关 #teslatakedown 的帖子，并总结最近的事件”）

工具列表

get-pinned-feeds：返回经过身份验证用户的“固定”项目集合。
get-timeline-posts：返回经过身份验证用户的主页时间线上的帖子
get-feed-posts：返回指定信息流中的帖子
get-list-posts：返回指定列表中的帖子
get-user-posts：返回指定用户的帖子
get-profile：返回指定用户的基本资料信息
get-follows：返回当前用户关注的一组用户
get-liked-posts：返回经过身份验证的用户最近喜欢的帖子
get-trends：返回蓝天下上当前的趋势主题及其帖子数量
search-posts：根据查询返回帖子，可以选择最新的或最热门的
search-people：根据查询返回用户
search-feeds：根据查询返回信息流
like-post：使用特定 URI 对帖子进行点赞
create-post：发布一条帖子
follow-user：关注指定的用户

📦 安装指南

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

# 安装依赖
pnpm install

# 构建项目
pnpm run build

使用 MCP Inspector 测试

你可以通过神奇的 MCP Inspector 直接测试蓝天下工具，而无需连接到 LLM。首先确保你已经构建了服务器，然后运行：

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

在终端提供的本地 URL 中导航，并从左侧的面板设置你的 BLUESKY_IDENTIFIER、BLUESKY_APP_PASSWORD 和 BLUESKY_SERVICE_URL 环境变量。尝试使用 get-timeline 工具查看你时间线上最近的帖子。

💻 使用示例

基础用法

在 Claude for desktop 中连接到蓝天下，将以下内容添加到 bluesky 部分的 claude_desktop_config.json：

{
    "mcpServers": {
      "bluesky": {
        "command": "node",
        "args": ["/path/to/bsky-mcp-server/build/src/index.js"],
        "env": {
            "BLUESKY_IDENTIFIER": "你的 Bluesky 用户名",
            "BLUESKY_APP_PASSWORD": "你的 Bluesky 应用密码",
            "BLUESKY_SERVICE_URL": "Bluesky 服务 URL"
        }
      }
    }
}

📚 详细文档

创建应用密码

登录到你的蓝天下账户。
访问你的设置。
选择“应用”选项卡。
点击“创建新应用”按钮。
填写应用详细信息并保存，系统将为你生成应用密码。

🔧 技术细节

安全性：此服务器仅在内存中保留会话信息，不会将其持久化到本地磁盘或远程服务。

📄 许可证

本项目使用 MIT 许可证。

brianellin_bsky-mcp-server