Kiseki Labs Readwise MCP

🚀 Kiseki-Labs-Readwise-MCP 服務器

Kiseki-Labs-Readwise-MCP 是一款專為與 Readwise API 交互而打造的模型上下文協議（MCP）服務器。它能讓語言模型對您的 Readwise 文檔和高亮內容進行訪問與操作，該服務器由 Kiseki Labs 開發。

🚀 快速開始

Kiseki-Labs-Readwise-MCP 服務器可助力語言模型與 Readwise API 交互，實現對 Readwise 文檔和高亮內容的訪問與操作。以下將為您詳細介紹其安裝、配置及運行方法。

📦 安裝指南

克隆倉庫

git clone <your-repository-url>
cd readwise_mcp

使用 uv 初始化依賴

假設您已安裝 uv，執行以下命令：

uv sync

🔧 配置說明

此服務器運行依賴 Readwise API 密鑰，您可按以下步驟完成配置：

1. 從 Readwise 獲取 API 密鑰。
2. 在項目根目錄創建 .env 文件。
3. 將 API 密鑰添加至 .env 文件：

READWISE_API_KEY=your_readwise_api_key_here

服務器會藉助 python-dotenv 自動加載該變量。

✨ 主要特性

服務器提供了以下工具供您進行交互：

• find_readwise_document_by_name(document_name: str) -> Book | None：依據確切名稱查找特定文檔。
• list_readwise_documents_by_filters(document_category: str = "", from_date: Optional[date] = None, to_date: Optional[date] = None) -> List[Book]：按照類別（如 'books', 'articles'）和/或日期範圍列出文檔，至少需設置一個過濾器。
• get_readwise_highlights_by_document_ids(document_ids: List[int]) -> List[Highlight]：獲取特定文檔 ID 列表對應的所有高亮內容。
• get_readwise_highlights_by_filters(from_date: Optional[date] = None, to_date: Optional[date] = None, tag_names: List[str] = []) -> List[Highlight]：根據日期範圍和/或標籤列表獲取高亮內容，至少需設置一個過濾器。

注意：Book 和 Highlight 指的是 readwise_mcp.types 模塊中定義的數據結構。

💻 使用示例

運行服務器

開發模式

若要在開發模式下運行 MCP 服務器，可從項目根目錄執行以下命令：

uv run mcp dev server.py

若未修改主機和端口，開發服務器將啟動並默認在 http://127.0.0.1:6274/ 上可訪問。

在 Claude 中安裝 MCP 服務器

在 MacBook 上，您可按以下步驟操作：

1. 打開以下文件：

~/Library/Application\ Support/Claude/claude_desktop_config.json

例如，使用 vim 打開該文件，可運行命令：

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. 在 mcpServers 對象下添加相應條目，示例如下：

"mcpServers": {
    "Kiseki-Labs-Readwise-MCP": {
      "command": "/Users/eddie/.pyenv/shims/uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "/Users/eddie/Development/AI/mcp_servers/readwise_mcp/server.py"
      ]
    }
    ...

3. 保存文件後，重新啟動 Claude。重啟後，Kiseki-Labs-Readwise-MCP MCP 服務器即可使用。