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 会自动发布版本