🚀 Kiseki-Labs-Readwise-MCP 服务器
Kiseki-Labs-Readwise-MCP 是一款专为与 Readwise API 交互而打造的模型上下文协议（MCP）服务器。它能让语言模型对您的 Readwise 文档和高亮内容进行访问与操作，该服务器由 Kiseki Labs 开发。
🚀 快速开始
Kiseki-Labs-Readwise-MCP 服务器可助力语言模型与 Readwise API 交互，实现对 Readwise 文档和高亮内容的访问与操作。以下将为您详细介绍其安装、配置及运行方法。
📦 安装指南
克隆仓库
git clone
cd readwise_mcp
使用 uv 初始化依赖
假设您已安装 uv，执行以下命令：
uv sync
🔧 配置说明
此服务器运行依赖 Readwise API 密钥，您可按以下步骤完成配置：
- 从 Readwise 获取 API 密钥。
- 在项目根目录创建
.env文件。 - 将 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 上，您可按以下步骤操作：
- 打开以下文件：
~/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-MCPMCP 服务器即可使用。