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: 通过确切名称在 Readwise 中查找特定文档。
• 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 服务器应该可用。