Zulook

🚀 zulook

zulook 可對 Zulip 對話進行只讀訪問。它既可以作為命令行工具（CLI）使用，也能充當 MCP 服務器或 ACP 代理。

只需提供一個 Zulip URL，就能獲取相應的消息，就這麼簡單。

$ zulook https://rust-lang.zulipchat.com/#narrow/stream/213817-t-lang/topic/test

Messages from t-lang > test:

**Alice** (2025-01-15 14:32 UTC) [test]
Has anyone looked at the new RFC?

**Bob** (2025-01-15 14:35 UTC) [test]
Yes, I left some comments on the thread.

Older: https://rust-lang.zulipchat.com/#narrow/channel/213817-t-lang/topic/test/near/12340
Newer: https://rust-lang.zulipchat.com/#narrow/channel/213817-t-lang/topic/test/near/12345

🚀 快速開始

在使用 zulook 之前，你需要進行一些設置。

📦 安裝指南

你需要一個 Zulip API 密鑰，最簡單的獲取方式如下：

1. 登錄你的 Zulip 實例。
2. 進入 個人設置 > 賬戶與隱私。
3. 點擊 管理你的 API 密鑰，輸入你的密碼。
4. 點擊 下載 .zuliprc。
5. 將其移動到 ~/zuliprc：

   mv ~/Downloads/.zuliprc ~/zuliprc
   

配置文件路徑遵循 zulip-terminal 的約定：~/zuliprc（無點號）。

或者，你也可以設置環境變量：

export ZULIP_URL=https://your-org.zulipchat.com
export ZULIP_EMAIL=you@example.com
export ZULIP_API_KEY=your_api_key

💻 使用示例

基礎用法

CLI 方式

zulook <url> [limit=N]

你可以傳入任何 Zulip URL，包括流、主題、直接消息、群組直接消息，無論是否帶有 /near/ 錨點。默認的消息數量限制為 100 條。

# 流主題
zulook https://rust-lang.zulipchat.com/#narrow/stream/213817-t-lang/topic/test

# 直接消息對話
zulook https://rust-lang.zulipchat.com/#narrow/dm/116009,116107-dm/near/572348733

# 獲取較少的消息
zulook https://rust-lang.zulipchat.com/#narrow/stream/213817-t-lang/topic/test limit=20

輸出結果中會包含 Older 和 Newer 鏈接，方便你瀏覽歷史消息。

MCP 服務器方式

zulook mcp

以 MCP 服務器的形式通過標準輸入輸出運行。它提供了一個 zulip 工具，你可以給它傳入一個 URL 或者 "help"。

Claude Code 配置（~/.claude/settings.json）：

{
  "mcpServers": {
    "zulook": {
      "command": "/path/to/zulook",
      "args": ["mcp"]
    }
  }
}

ACP 代理方式

zulook acp

以 ACP 代理的形式通過標準輸入輸出運行，可與 ACP 導體配合使用。

🔧 技術細節

zulook 會解析 Zulip 的窄化 URL，從 URL 片段中提取流/頻道、主題、直接消息參與者和消息錨點。然後，它會使用相應的窄化過濾器調用 Zulip REST API（GET /api/v1/messages），並返回格式化後的消息。

URL 是唯一的交互接口。只有一個工具、一種命令模式，分頁操作只需跟隨鏈接即可，這些鏈接與你在瀏覽器中看到的是一樣的。

🛠️ 構建

cargo build --release

構建該項目需要 Rust 2024 版本。