Kiseki-Labs-Readwise-MCP

概述

Kiseki-Labs-Readwise-MCP 是一个设计用于与 Readwise API 交互的模型上下文协议（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: 根据确切名称查找特定文档。
• list_readwise_documents_by_filters(document_category: str = "", from_date: Optional[date] = None, to_date: Optional[date] = None) -> List[Book]: 根据类别（例如，'书籍'，'文章'）和/或日期范围列出文档。至少需要一个过滤器。
• 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 服务器应该可用。