Readwise MCP Server
2025.03.22
8
TypeScript知识管理API 集成内容生成开发效率
Readwise MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于访问和交互用户的 Readwise 库。它提供了访问高亮内容、搜索高亮内容、获取书籍和文档等功能，并支持与 Claude 和其他 MCP 兼容助手的无缝集成。该服务具有增强的提示能力、传输感知的日志系统、健壮的错误处理和验证、MCP 协议合规性以及健康检查端点等特性。
View on GitHub
Overview
基本能力
产品定位
Readwise MCP Server 是一个用于访问和交互 Readwise 库的服务，支持与 MCP 兼容的助手集成。
核心功能
- 访问 Readwise 库中的高亮内容
- 使用自然语言查询搜索高亮内容
- 获取库中的书籍和文档
- 与 Claude 和其他 MCP 兼容助手的无缝集成
- 增强的高亮分析提示能力
- 传输感知的日志系统
- 健壮的错误处理和验证
- MCP 协议合规性，包括 request_id 处理
- 健康检查端点
- 改进的设置向导，支持 API 密钥验证
适用场景
- 个人知识管理
- 内容分析和总结
- 开发与测试 MCP 兼容的助手
- 自动化工作流集成
工具列表
- get_highlights: 获取 Readwise 库中的高亮内容
- get_books: 获取 Readwise 库中的书籍
- get_documents: 获取 Readwise 库中的文档
- search_highlights: 在 Readwise 库中搜索高亮内容
常见问题解答
- 如何获取 API 密钥？从 https://readwise.io/access_token 获取。
- 如何测试而不使用真实 API 密钥？使用
npm run test-mock运行模拟测试。
使用教程
使用依赖
- Node.js 环境
- npm 包管理器
安装教程
# 从 npm 安装
npm install -g readwise-mcp
# 或克隆仓库并安装依赖
git clone https://github.com/your-username/readwise-mcp.git
cd readwise-mcp
npm install
npm run build
设置
# 运行设置向导
npm run setup
# 或直接使用 API 密钥启动
readwise-mcp --api-key YOUR_API_KEY
调试方式
# 启动 stdio 传输（默认）
readwise-mcp
# 启动 SSE 传输
readwise-mcp --transport sse --port 3000
# 启用调试日志
readwise-mcp --debug
测试
# 运行自动化检查器测试
npm run test-inspector
# 运行 CI 模式测试
npm run test-inspector:ci
# 使用 shell 脚本测试
./scripts/inspector.sh
# 使用 TypeScript 脚本测试
npm run inspector