Kiseki-Labs-Readwise-MCP

Kiseki-Labs-Readwise-MCP

概述

Kiseki-Labs-Readwise-MCP 是一个用于与 Readwise API 交互的 Model Context Protocol（MCP）服务。

它允许大模型以编程方式访问和管理你的 Readwise 文档和高亮内容。此服务由 Kiseki Labs 开发。

安装

1. 克隆代码库：

   git clone <your-repository-url>
   cd readwise_mcp
   

2. 使用 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：按确切名称查找 Readwise 中的特定文档。
• 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 上使用你喜欢的文本编辑器打开以下文件：

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

例如，使用 vim 打开此文件时，可以运行以下命令：

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

然后在 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"
      ]
    }
    ...

保存所做的更改。 最后，重启 Claude。重启后，Kiseki-Labs-Readwise-MCP MCP 服务应该即可使用。