rm MCP

可重新标记的MCP服务器

释放您的可重新标记平板电脑的全部潜力 第二大脑 AI助手。此MCP服务器允许Claude、VS Code Copilot和其他AI工具读取、搜索和遍历整个可标记库，包括通过OCR的手写笔记。

为什么选择rm-mcp？

你的可标记平板电脑是思考、记笔记和研究的强大工具。但这些知识仍被困在设备上。此MCP服务器更改了以下内容：

• 完全访问图书馆 --浏览文件夹、搜索文档、读取任何文件
• 键入文本提取 --原生支持Type Folio和类型化注释
• 手写OCR --将手写笔记转换为可搜索文本
• PDF和EPUB支持 --从文档中提取文本，以及您的注释
• 智能搜索 --在整个库中查找内容
• 第二次大脑整合 --与黑曜石、笔记应用程序或任何人工智能工作流程一起使用

无论你是在研究、写作还是开发想法，rm mcp都可以让你通过人工智能利用reMarkable上的一切。

______________________________________________________________________

快速安装

使用可重新标记云API。需要可重新标记的Connect订阅。

一个命令设置（推荐）

uvx rm-mcp --setup

这将打开您的浏览器，提示输入一次性代码，并打印Claude code和Claude Desktop的即贴配置。

手动设置

1.获取一次性代码

首选 my.remarkable.com/device/browser/connect 并生成代码。

2.转换为Token

uvx rm-mcp --register YOUR_CODE

3.添加到您的MCP客户端

克劳德代码：

claude mcp add remarkable \
  -e REMARKABLE_TOKEN='
' \
  -e REMARKABLE_OCR_BACKEND=sampling \
  -- uvx rm-mcp@latest

克劳德桌面 --添加到 claude_desktop_config.json （使用完整路径 uvx例如，从 which uvx):

{
  "mcpServers": {
    "remarkable": {
      "command": "/Users/YOU/.local/bin/uvx",
      "args": ["rm-mcp@latest"],
      "env": {
        "REMARKABLE_TOKEN": "
"
      }
    }
  }
}

______________________________________________________________________

______________________________________________________________________

工具

所有工具都是 只读 并返回带有下一步操作提示的结构化JSON。

📖 完整工具文档

智能功能

• 多页阅读 --一次阅读所有页面 pages="all"，或类似的范围 pages="1-3"
• Grep自动重定向 — grep 自动查找并跳转到匹配的页面
• 自动重定向 --浏览文档路径会自动返回其内容
• 自动OCR --没有键入文本的笔记本会自动启用OCR（选择退出 auto_ocr=False)
• 全文搜索 --读取文档会为其建立索引，以便将来快速搜索
• 紧凑模式 --使用 compact_output=True 减少响应中的令牌使用
• 批量搜索 --在一次通话中搜索多个文档
• 视觉支持 --获取视觉背景的页面图像（图表、模型、草图）
• OCR采样 -使用客户的AI对图像进行OCR（不需要API密钥）

示例用法

# Read a document
remarkable_read("Meeting Notes")

# Read all pages at once
remarkable_read("Meeting Notes", pages="all")

# Read a range of pages
remarkable_read("Research Paper", pages="1-3")

# Search for keywords (auto-redirects to matching page)
remarkable_read("Project Plan", grep="deadline")

# Enable OCR for handwritten notes
remarkable_read("Journal", include_ocr=True)

# Browse your library
remarkable_browse("/Work/Projects")

# Search across documents
remarkable_search("meeting", grep="action items")

# Get recent documents with previews
remarkable_recent(limit=5, include_preview=True)

# Get a page image
remarkable_image("UI Mockup", page=1)

# Get image with OCR text extraction
remarkable_image("Handwritten Notes", include_ocr=True)

______________________________________________________________________

资源

文档会自动注册为MCP资源：

📖 完整资源文档

______________________________________________________________________

OCR手写

rm mcp使用 OCR采样 --MCP客户端的AI模型从手写笔记中提取文本。不需要额外的API密钥或服务。

运作原理

当你使用 include_ocr=True，rm mcp通过mcp采样将页面图像发送到客户的LLM（Claude、GPT-4等）。模型读取笔迹并返回文本。

用法

# OCR on a page image
remarkable_image("Handwritten Notes", include_ocr=True)

# OCR when reading a notebook
remarkable_read("Journal", include_ocr=True)

需求

• 您的MCP客户端必须支持 采样 功能（VS Code+Copilot、Claude Desktop等）
• REMARKABLE_OCR_BACKEND=sampling （这是默认设置）

______________________________________________________________________

高级配置

根路径过滤

将MCP服务器限制在reMarkable上的特定文件夹中。所有操作都将作用于此文件夹：

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["rm-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "your-token",
        "REMARKABLE_ROOT_PATH": "/Work"
      }
    }
  }
}

使用此配置：

• remarkable_browse("/") 显示以下内容 /Work
• remarkable_browse("/Projects") 显示 /Work/Projects
• 外部文件 /Work 无法访问

适用于：

• 在办公时间专注于工作文件
• 将个人笔记和专业笔记分开
• 限制特定AI工作流程的范围

自定义背景颜色

设置图像渲染的默认背景颜色：

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["rm-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "your-token",
        "REMARKABLE_BACKGROUND_COLOR": "#FFFFFF"
      }
    }
  }
}

支持的格式：

• #RRGGBB --RGB十六进制（例如。， #FFFFFF 白色）
• #RRGGBBAA --RGBA十六进制（例如。， #00000000 透明）

默认值为 #FBFBFB （可重新标记的纸张颜色）。这会影响到 remarkable_image 工具和图像资源。

所有环境变量

大多数用户只需要 REMARKABLE_TOKEN其余的用于高级调音。

______________________________________________________________________

用例

研究与写作

在黑曜石金库或类似库中工作时，使用rm mcp将手写笔记中的知识转移到结构化文档中。人工智能可以阅读你的研究笔记，帮助你发展想法。

每日评论

让你的人工智能助手总结你最近的笔记，找到行动项目，或者在你的日记条目中识别模式。

文档搜索

通过在整个图书馆中搜索，包括手写内容，找到那张记不住的便条。

知识管理

将你的reMarkable视为人工智能可以访问的第二个大脑。结合黑曜石等工具，你可以构建一个强大的个人知识体系。

______________________________________________________________________

文档

______________________________________________________________________

发展

git clone https://github.com/wavyrai/rm-mcp.git
cd rm-mcp
uv sync --all-extras
uv run pytest test_server.py -v

📖 开发指南

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________