bluesky-daily-mcp

一个 MCP 服务器，帮助你从你关注的 Bluesky 用户中发现每日最有趣的话题。

功能

• 一个用于检索你关注的用户在给定日期发布的所有帖子的工具
• 用于分析帖子的示例提示
• 缓存给定日期的帖子

帖子通过 bsky-tldr npm 包检索，该包将它们规范化为以下格式，以便 LLM 轻松使用：

[
  {
    "uri": "at://did:plc:kft6lu4trxowqmter2b6vg6z/app.bsky.feed.post/3lh4unyelgs2i",
    "content": "There are some missing details in this report claiming to have leaked the system prompt - most notably they don't clarify if they got the system prompt for DeepSeek v3 or DeepSeek R1 (I'm interred in R1) lab.wallarm.com/jailbreaking...",
    "createdAt": "2025-02-01T15:53:09.612Z",
    "isRepost": false,
    "links": ["https://lab.wallarm.com/jailbreaking-generative-ai/"]
  }
]

<img src="https://github.com/briangershon/bluesky-daily-mcp/blob/main/screenshots/visual-summary-of-bluesky-posts.jpg?raw=true" width="600" height="600" alt="Visual Summary of Bluesky Posts" />

局限性

• 这会检索你关注的用户在给定日期发布的所有帖子。 这将变得很大，并且随后你将丢失被 MCP 客户端或 LLM 的上下文窗口截断的帖子。 需要额外的策略来处理这个问题。

安装

将此 MCP 服务器与你的 MCP 客户端一起安装，例如 Claude Desktop。

以下是步骤：

👉 1. 配置。 对于 Claude Desktop，你可以通过将以下内容添加到你的 ~/Library/Application\ Support/Claude/claude_desktop_config.json（在 MacOS 上）来安装此 MCP 服务器：

选项 A：从 NPM 包运行

注意：只有在使用 NVM 管理你的 Node.js 版本时，才需要指向 npx 运行的 /bin 文件夹的绝对路径的 PATH。 如果没有它，你可能会看到一个神秘的“Header not set”错误。 通过 which npx 命令查找路径。

{
  "mcpServers": [
    "bluesky-daily-mcp": {
      "command": "npx",
      "args": ["-y", "bluesky-daily-mcp"],
      "env": {
        "PATH": "/absolute/path/to/npx/bin:/usr/bin:/bin",
        "BLUESKY_HANDLE": "",
        "BLUESKY_APP_PASSWORD": "",
        "TIMEZONE_OFFSET": "-8",
        "REQUEST_TIMEOUT_MS": "120000"
      }
    }
  ]
}

选项 B：克隆 repo 并从源代码运行

首先在克隆的 repo 中构建 MCP 服务器：

npm install
npm run build

注意：只有在使用 NVM 管理你的 Node.js 版本时，才需要 node 的 /absolute/path。 如果没有它，你可能会看到一个神秘的“Header not set”错误。 通过 which node 命令查找路径。

{
  "mcpServers": [
    "bluesky-daily-mcp": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/this/dist/index.js"],
      "env": {
        "BLUESKY_HANDLE": "",
        "BLUESKY_APP_PASSWORD": "",
        "TIMEZONE_OFFSET": "-8",
        "REQUEST_TIMEOUT_MS": "120000"
      }
    }
  ]
}

这些环境变量是什么？

• BLUESKY_HANDLE 是你的 Bluesky 句柄，不带 @ 符号，例如 your_handle.bsky.social 或 customdomain.com。
• BLUESKY_APP_PASSWORD 是一个 Bluesky 应用程序密码，你可以从 Bluesky 应用程序密码设置页面 生成。
• TIMEZONE_OFFSET 是与 UTC 的时区偏移量，以小时为单位。 例如，PST 为 -8，CST 为 +8。 这有助于定义对你来说的“一天”是什么，因此它不会硬编码为 UTC。
• REQUEST_TIMEOUT_MS 是检索帖子的请求运行的最大超时时间。 如果没有这个，你将有一个默认的约 60 秒（60000 毫秒）。 建议将其设置为 2 分钟（120000 毫秒）。

👉 2. 重启 Claude Desktop 以加载新的 MCP 服务器。

试用

• 启动 Claude Desktop 并开始新的对话
• 输入“Retrieve Bluesky posts from yesterday”或“Retrieve Bluesky posts from April 2nd”（或你想要的任何日期）

<img src="https://github.com/briangershon/bluesky-daily-mcp/blob/main/screenshots/claude-desktop.png?raw=true" width="800" alt="Using MCP Server with Claude Desktop" />

贡献者帮助

在本地运行以进行开发

使用以下内容设置你的本地 .env 文件：

BLUESKY_HANDLE=
BLUESKY_APP_PASSWORD=
TIMEZONE_OFFSET=

使用 MCP Inspector 调试：

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
```

通过查看日志调试

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

运行测试或覆盖率报告

npm test
npm run coverage

手动检索帖子

如果你想确保帖子检索代码使用你的 .env 运行正常，请运行：

npm run retrieve-posts

将包发布到 NPM 的步骤

将最新代码合并到主分支后：

1. 在本地，git checkout main && git pull
2. npm version patch # 或 minor, 或 major
3. git push --follow-tags
4. GitHub 发布会自动编写和发布