Kiseki Labs Readwise MCP

Kiseki Labs Readwise MCP

概述

Kiseki-Labs-Readwise-MCP 是一个模型上下文协议（MCP）服务器，设计用于与Readwise API交互。

它允许语言模型以编程方式访问和操作Readwise文档和突出显示。此服务器由开发 Kiseki实验室.

安装

1. 克隆存储库：

   git clone 
   cd readwise_mcp

1. 使用uv初始化依赖关系

*（假设你有 紫外线 已安装）*

   uv sync

配置

此服务器需要Readwise API密钥才能运行。

1. 从获取API密钥 Readwise.
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"
      ]
    }
    ...

保存包含这些更改的文件。 最后，重启克劳德。重启后 Kiseki-Labs-Readwise-MCP MCP服务器应可用。