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 服务器即可使用。