🚀 bluesky-daily-mcp
bluesky-daily-mcp 是一个 MCP 服务器，能每日从你在 Bluesky 关注的人中挖掘出最有趣的主题，帮助你高效探索 Bluesky 信息流。
更多使用示例，请参考 "构建探索你的 Bluesky Feed 的 MCP 服务器"。
🚀 快速开始
启动 Claude Desktop 并开启新对话，输入 "检索昨天的 Bluesky 帖子" 或 "检索 4 月 2 日的 Bluesky 帖子"（或其他任何日期），即可尝试使用该服务器。
✨ 主要特性
- 帖子检索：可检索某一天你关注的所有帖子。
- 示例提示分析：提供分析帖子的示例提示。
- 帖子缓存：能缓存给定某一天的帖子。
- 高效信息获取：借助
bsky-tldrnpm 包，（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 的步骤
在将最新代码合并到主要分支后：
- 本地：
git checkout main && git pull npm version patch# 或 minor，或 majorgit push --follow-tags- GitHub 会自动发布版本