🚀 蓝天下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 许可证。