← 返回目录

reMarkable MCP Server

社区

将 reMarkable 平板电脑作为 AI 助手的“第二大脑”——读取文档、浏览文件、提取文字并进行手写识别。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 云存储第 3 / 15
Stars: ★ 243 热门
传输方式: stdio（本地进程）
运行环境: Python
凭据: 可选 API Key
许可证: MIT
最近提交: 10 天前
工具数: 13

65FMRS · C

该服务器为在 AI 工作流中利用 reMarkable 笔记提供了强大且灵活的集成。它支持多种连接模式，具有全面的读写工具，并提供智能功能如自动 OCR 和标签过滤。活跃的开发和清晰的文档增加了其可用性。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

14/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 10/20: 证据：仓库包含测试文件（如test_server.py）和烟雾测试脚本（smoke/run_smoke.py），README中描述了详细的工具列表和传输模式。未发现自相矛盾的声明；但服务器路径（server.json）仅提供概要清单，未提供代码级验证。限制：由于静态审查没有执行，且依赖的库（PyMuPDF、rmscene）和外部服务（Google Vision）的失败模式不可控，可靠性评分上限为10。
安全与权限 12/20: 证据：凭证处理良好，REMARKABLE_TOKEN标记为秘密，并提供注册流程；删除操作默认需要确认，无确认时拒绝；支持只读模式；凭据不嵌入安装示例。限制：写入工具默认启用，但文档明确说明；外部网络调用（Google Vision）未明确披露数据流；删除的确认机制依赖客户端支持，且在某些环境下可能被跳过；未发现恶意行为或越权，故评分不触发红色底线。
维护活跃度 14/20: 证据：仓库活跃（191星，22个未关闭问题），有MIT许可证，有文档化的路线图和开发指南，README显示持续更新。限制：无版本亮点或发布节奏信息，依赖更新未明确说明；维护评分基于可见的仓库活跃度，但未核实提交历史或问题响应。
文档质量 16/20: 证据：文档全面，包括安装指南（USB、SSH、云）、OCR设置、工具参考、资源参考、故障排除和能力协商，并提供示例。限制：某些高级功能（如画布）依赖客户端特定支持，未提供截图证据；文档为自述性质，未经测试验证。
安装易用性 13/20: 证据：提供多种安装方式（USB、SSH、云），包含VS Code一键安装按钮和手动JSON配置示例，环境变量和API密钥获取有明确说明。限制：安装依赖外部工具（uvx、Google Vision等），且文档未提供所有平台的详细故障排除；静态审查无法验证安装步骤的实际可执行性。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络

适合谁

reMarkable 用户希望在 AI 工作流中利用设备上的笔记和文档。
需要在无设备连接时访问库的远程或无人值守场景（云端模式）。
希望通过 USB 快速离线访问且无需订阅的用户（USB Web 模式）。

不适合谁

不需要 reMarkable 设备或不想管理多个 API 密钥的用户。
需要官方支持或企业级 SLA 的团队。
对硬件无所有权且希望自定义协议的用户。

所需权限

需要访问 reMarkable 云 API 的认证令牌（`REMARKABLE_TOKEN`）——必须保密。
USB/SSH 模式需要 USB 连接和/或 SSH 权限，并可访问平板文件系统。
默认启用写入操作；删除等破坏性操作需要确认（如果客户端支持）或设置 `REMARKABLE_SKIP_CONFIRM=1`。
可选 Google Vision API 密钥用于 OCR。

风险与副作用

写入工具可能导致数据丢失；删除是破坏性的，务必谨慎。
云模式需要 reMarkable Connect 订阅，可能产生成本。
Google Vision OCR 可能产生费用（每月 1000 次免费请求，超出后每千次约 1.50 美元）。
无意中将敏感笔记暴露给 AI 提供商的风险。
SSH 模式需要开发者模式，可能导致保修失效。

安装接入

准备工作

运行环境：Python

REMARKABLE_TOKEN 可选密钥 reMarkable Cloud API 令牌，在 my.remarkable.com/device/desktop/connect 用一次性代码通过 `uvx remarkable-mcp --register` 生成；云模式必需。

GOOGLE_VISION_API_KEY 可选密钥 Google Cloud Vision API 密钥，用于手写 OCR；在 Google Cloud Console 的凭据页面创建。

其他可选配置项（12 个）

REMARKABLE_OCR_BACKEND 可选选择 OCR 后端：sampling、google、tesseract 或 auto（默认）。

REMARKABLE_READ_ONLY 可选设为 1 时以只读模式运行服务器，禁用所有写工具。

REMARKABLE_SKIP_CONFIRM 可选设为 1 时允许在客户端不支持 MCP elicitation 的情况下直接删除。

REMARKABLE_ROOT_PATH 可选把服务器所有操作限制在 reMarkable 上的指定文件夹，如 /Work。

REMARKABLE_BACKGROUND_COLOR 可选页面图片渲染的默认背景色，格式 #RRGGBB 或 #RRGGBBAA，默认 #FBFBFB。

REMARKABLE_RETRY_ATTEMPTS 可选云 API 请求的最大尝试次数，默认 3。

REMARKABLE_RETRY_DELAY 可选指数退避的基础延迟秒数，默认 2.0。

REMARKABLE_SYNC_WORKERS 可选云模式并行拉取库内容的 worker 数，默认 16（上限 64）。

REMARKABLE_DISABLE_CACHE 可选设为 1 时完全禁用云模式的磁盘 blob 缓存。

REMARKABLE_CACHE_DIR 可选云模式 blob 缓存目录，默认 ~/.remarkable/cache/blobs。

REMARKABLE_CACHE_MAX_BLOB 可选超过此大小的 blob 不写入缓存（流式处理），默认 4 MiB。

REMARKABLE_DISABLE_CLOUD_FALLBACK 可选设为 1 时禁用设备不可达时自动回退到云模式。

确保已安装 Python 和 uvx。
选择连接模式：USB Web（推荐）——在平板设置→存储中启用“USB web 接口”；SSH——启用开发者模式；云端——在 my.remarkable.com 获取一次性代码，然后用 uvx remarkable-mcp --register YOUR_CODE 转换为令牌。
如需手写 OCR，获取 Google Vision API 密钥并配置环境变量 GOOGLE_VISION_API_KEY。
在 MCP 客户端配置中添加服务器，例如 VS Code 的 .vscode/mcp.json 或 Claude Desktop 的配置文件。
根据连接模式启动 MCP 服务器。

MCP 配置 · JSON

{
  "mcpServers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--usb"],
      "env": {
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": [
        "remarkable-mcp",
        "--usb"
      ],
      "env": {
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add remarkable -e GOOGLE_VISION_API_KEY=your-api-key -- uvx remarkable-mcp --usb

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应看到 remarkable_read、remarkable_browse、remarkable_status 等工具；调用 remarkable_status 可确认当前连接模式（USB/SSH/Cloud）及能力矩阵。

常见排障

USB 连接失败：检查平板是否已解锁且 USB 连接正常，验证在设置→存储中启用了“USB web 接口”。
云端认证失败：确认令牌有效，必要时重新注册。
OCR 不工作：检查 `REMARKABLE_OCR_BACKEND` 设置和 API 密钥。
性能问题：调整 `REMARKABLE_SYNC_WORKERS` 和缓存设置。
连接被拒绝：确保防火墙或网络允许访问平板 IP（如 10.11.99.1）。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

读取我的 reMarkable 上名为 Meeting Notes 的文档内容
在我的全部笔记中搜索包含 action items 的内容，包括手写 OCR
把 paper.pdf 上传到 reMarkable 的 /Research 文件夹
给 UI Mockup 这个文档的第一页生成一张 PNG 图片

工具能力 13

remarkable_read 只读

读取并提取文档文本（支持分页和搜索）。

remarkable_browse 只读

浏览文件夹、按文档名搜索或按标签过滤。

remarkable_search 只读

跨多个文档搜索内容（支持标签过滤）。

remarkable_recent 只读

获取最近修改的文档。

remarkable_status 只读

检查连接状态和各传输模式的能力矩阵。

remarkable_image 只读

获取页面 PNG/SVG 图像（支持通过采样进行 OCR）。

remarkable_upload 写入

上传 PDF 或 EPUB 文件到 reMarkable。

remarkable_mkdir 写入

创建新文件夹（云端和 SSH 模式）。

展开其余 5 个工具

remarkable_move 写入

移动文档或文件夹（云端和 SSH 模式）。

remarkable_rename 写入

重命名文档或文件夹（云端和 SSH 模式）。

remarkable_delete 破坏性

删除文档或文件夹——具有破坏性（云端和 SSH 模式）。

remarkable_author 写入

创建原生墨迹和笔记本（仅 SSH 模式）。

remarkable_canvas 只读

在交互式画布中打开页面查看器。

使用场景

研究写作：将手写笔记传递到 Obsidian 等笔记应用。

每日回顾：让 AI 总结近期笔记、查找待办事项。

文档搜索：在整个笔记库中搜索，包括手写内容。

知识管理：将 reMarkable 作为 AI 可访问的第二大脑。

支持客户端

Claude

VS Code

ChatGPT

依据项目文档列出，未经本站实测。

详细介绍

reMarkable MCP Server 让 AI 助手能够访问 reMarkable 平板上的全部笔记和文档。它支持浏览文件夹、搜索文档、读取任何文件，包括从手写笔记中提取文字（OCR）。提供多种连接方式：USB Web 接口（推荐，无需订阅和开发者模式）、SSH（需要开发者模式）以及云端（需要 Connect 订阅，无设备也可用）。内置写入工具（上传、创建文件夹、移动、重命名、删除），支持通过 MCP 资源访问文档文本和页面图像。