Bluesky Daily MCP

🚀 bluesky-daily-mcp

bluesky-daily-mcp 是一個 MCP 服務器，它能每日從你在 Bluesky 關注的人中篩選出最有趣的主題。藉助這個工具，你可以輕鬆探索 Bluesky 動態，不錯過任何有價值的信息。

有關如何使用的示例，請參見 "構建探索你的 Bluesky Feed 的 MCP 服務器"。

🚀 快速開始

你可以啟動 Claude Desktop 並開啟新對話，輸入 "檢索昨天的 Bluesky 帖子" 或 "檢索 4 月 2 日 的 Bluesky 帖子"（或其他任何日期），即可開始使用本工具。

✨ 主要特性

• 帖子檢索：可檢索某一天你在 Bluesky 關注的所有帖子。
• 示例提示分析：提供分析帖子的示例提示。
• 帖子緩存：能夠緩存給定某一天的帖子。

通過 bsky-tldr npm 包，本工具（a）獲取僅關鍵字段的信息，並且（b）確保按請求的某一天高效檢索帖子。同時，在此 MCP 服務器中，我們添加了更具描述性的字段名稱，並將作者和帖子信息組合在一起以方便 LLM 消費：

type StandalonePost = {
  urlToOriginalPost: string;
  authorIdentifier: string;
  authorNameOrHandle: string;
  content: string;
  links: string[];
  isRepost: boolean;
};

📦 安裝指南

👉 1. 配置 .env 文件： 在項目根目錄下創建一個 .env 文件，並添加以下內容：

BLUESKY_HANDLE=你的Bluesky-handle
BLUESKY_APP_PASSWORD=你的Bluesky-app-password
TIMEZONE_OFFSET=時區偏移量（例如：Asia/Shanghai 或 UTC+8）

👉 2. 安裝依賴並構建： 運行以下命令安裝項目依賴項：

npm install

然後構建項目：

npm run build

🔧 技術細節

侷限性

• 該工具檢索某一天你關注的所有帖子，數據量可能會變得龐大，隨後你會丟失被 MCP 客戶端或 LLM 丟棄的帖子。
• 建議每天只檢索必要的內容。

貢獻者幫助

本地開發運行

為開發設置本地 .env 文件：

BLUESKY_HANDLE=你的Bluesky-handle
BLUESKY_APP_PASSWORD=你的Bluesky-app-password
TIMEZONE_OFFSET=時區偏移量（例如：Asia/Shanghai 或 UTC+8）

使用 MCP 檢查器進行調試：

npm install
npm run build && npx @modelcontextprotocol/inspector -e BLUESKY_HANDLE=XXX -e BLUESKY_APP_PASSWORD=XXX -e TIMEZONE_OFFSET=XXX node dist/index.js

通過查看日誌進行調試：

tail -n 20 -F ~/Library/Logs/Claude/mcp-server-bluesky-daily-mcp.log

運行測試或生成覆蓋率報告

npm test
npm run coverage

手動檢索帖子

如果你希望確保你的 .post.retrieve 代碼運行正常，請運行：

npm run retrieve-posts

發佈到 NPM 的步驟

在將最新代碼合併到主要分支後：

1. 本地：git checkout main && git pull
2. npm version patch # 或 minor，或 major
3. git push --follow-tags
4. GitHub 會自動發佈版本