Brianellin Bsky MCP Server

🚀 藍天下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"
        }
      }
    }
}

📚 詳細文檔

創建應用密碼

1. 登錄到你的藍天下賬戶。
2. 訪問 你的設置。
3. 選擇“應用”選項卡。
4. 點擊“創建新應用”按鈕。
5. 填寫應用詳細信息並保存，系統將為你生成應用密碼。

🔧 技術細節

• 安全性：此服務器僅在內存中保留會話信息，不會將其持久化到本地磁盤或遠程服務。

📄 許可證

本項目使用 MIT 許可證。