Kiseki-Labs-Readwise-MCP

Kiseki-Labs-Readwise-MCP

site icon
2025.04.20 2
Python知识管理API集成内容生成
Kiseki-Labs-Readwise-MCP 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 Readwise API 进行交互。它允许语言模型通过编程方式访问和操作用户的 Readwise 文档和高亮内容。该服务由 Kiseki Labs 开发,旨在为开发者提供一个高效的工具来管理和利用 Readwise 中的知识资源。
View on GitHub

Overview

基本能力

产品定位

Kiseki-Labs-Readwise-MCP 是一个中间件服务,旨在桥接语言模型和 Readwise 知识管理平台,实现数据的自动化访问和处理。

核心功能

  1. 文档查找:通过名称精确查找 Readwise 中的文档。
  2. 文档列表:根据类别和日期范围筛选列出文档。
  3. 高亮提取:通过文档ID或筛选条件获取相关高亮内容。

适用场景

  1. 知识管理自动化:自动整理和分类 Readwise 中的阅读材料。
  2. 内容生成:基于高亮内容生成摘要或报告。
  3. 研究辅助:快速检索和引用阅读材料中的关键信息。

工具列表

  1. find_readwise_document_by_name:按名称查找特定文档。
  2. list_readwise_documents_by_filters:根据类别和日期范围列出文档。
  3. get_readwise_highlights_by_document_ids:通过文档ID获取高亮。
  4. get_readwise_highlights_by_filters:通过日期范围和标签获取高亮。

常见问题解答

  1. API密钥:需要从 Readwise 获取并配置在 .env 文件中。
  2. 依赖管理:使用 uv 工具进行依赖同步。

使用教程

使用依赖

  1. 确保已安装 uv 工具。
  2. 克隆仓库后运行依赖同步命令:
uv sync

安装教程

  1. 克隆仓库:
git clone <your-repository-url>
cd readwise_mcp
  1. 配置 .env 文件:
READWISE_API_KEY=your_readwise_api_key_here

调试方式

  1. 开发模式运行:
uv run mcp dev server.py
  1. 默认访问地址:http://127.0.0.1:6274/

许可证

该项目遵循 None 开源许可条款。