读者 MCP 服务器
概述
一个模型上下文协议 (MCP) 服务器,可与您的Readwise 阅读器库无缝集成。此服务器支持兼容 MCP 的客户端(例如 Claude 和 VS Code)与您的阅读器库进行交互,提供文档列表、检索和更新功能。它充当 MCP 客户端与您在 Readwise 阅读器中的个人知识库之间的桥梁。
成分
工具
list_documents
- 通过灵活的过滤和分页功能列出阅读器中的文档。
- 输入:
location
(字符串,可选):要筛选的文件夹。以下选项之一: new
、 later
、 shortlist
、 archive
、 feed
。updatedAfter
(字符串,可选):仅返回在此 ISO8601 时间戳之后更新的文档。withContent
(布尔值,可选):如果为真,则在结果中包含 HTML 内容(默认值:false)。pageCursor
(字符串,可选):用于获取下一页的分页游标。
- 返回:
- 包含文档列表的 JSON 对象,每个文档包括元数据和(可选)内容,以及分页信息。
与 MCP 客户端一起使用
Claude Desktop / VS Code / 其他 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": {
"ACCESS_TOKEN": "your_readwise_access_token"
}
}
}
}
- 将
/absolute/path/to/your/reader/server
替换为此项目目录的实际路径。 - 将
your_readwise_access_token
替换为您的实际 Readwise Reader API 访问令牌。 - 或者,您可以在项目目录中的
.env
文件中指定ACCESS_TOKEN
。
有关更多信息,请参阅Readwise Reader API 文档和MCP 文档。