读取器MCP服务器
概述
一个模型上下文协议(MCP)服务器,与您的 Readwise阅读器 图书馆。此服务器使兼容MCP的客户端(如Claude和VS Code)能够与您的Reader库交互,提供文档列表、检索和更新功能。它是MCP客户端和Readwise Reader中个人知识库之间的桥梁。
组件
工具
list_documents
- 通过灵活的过滤和分页功能从Reader中列出文档。 - 输入: - location (字符串,可选):要筛选的文件夹。其中之一 new, later, shortlist, archive, feed. - updatedAfter (字符串,可选):仅返回在此ISO8601时间戳之后更新的文档。 - withContent (布尔值,可选):如果为true,则在结果中包含HTML内容(默认值:false)。 - pageCursor (字符串,可选):用于获取下一页的分页光标。 - 退货: - 带有文档列表的JSON对象,每个文档都包括元数据和(可选)内容,以及分页信息。
与MCP客户端一起使用
克劳德桌面/VS代码/其他MCP客户端
要将此服务器与Claude Desktop、VS Code或任何兼容MCP的客户端一起使用,请将以下配置添加到您的客户端设置中(例如。, claude_desktop_config.json 或 .vscode/mcp.json):
uv(本地服务器)
{
"mcpServers": {
"reader": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/your/reader/server",
"run",
"main.py"
],
"env": {
"READWISE_ACCESS_TOKEN": "your-token-here"
}
}
}
}- 替换
/absolute/path/to/your/reader/server带有此项目目录的实际路径。 - 替换
your-token-here使用您的实际Readwise Reader API访问令牌。 - 或者,您可以指定
READWISE_ACCESS_TOKEN在一个.env位于项目目录中的文件。
______________________________________________________________________
有关更多信息,请参阅 Readwise Reader API文档 和 MCP文件.
______________________________________________________________________
阅读技巧
此存储库还包括通过HTTP请求直接与Readwise Reader API交互的独立技能。该技能提供了在不需要MCP服务器的情况下使用阅读器API的知识和示例。
特性
- 列出、创建、更新和删除文档
- API全面覆盖(列表、保存、更新、删除、标记、批量操作)
- 身份验证和速率限制指南
- Python中的代码示例
安装
npx skills add xinthink/reader-mcp-server --skill reader有关安装和使用技能的更多信息,请参阅 Vercel Labs技能文档.
用法
安装后,当您询问Readwise Reader、保存文章或管理阅读列表时,该技能将自动触发。
