Remarkable MCP

可重新标记的MCP服务器

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

为什么是杰出的mcp？

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

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

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

______________________________________________________________________

快速安装

🔌 USB网络接口（推荐）

通过USB连接，并在平板电脑的存储设置中启用web界面。

![Install USB Web Mode in VS Code]() ![Install USB Web Mode in VS Code Insiders]()

设置：

1. 通过USB连接您的reMarkable
2. 在您的平板电脑上： 设置→ 存储 → 启用 “USB网络接口”
3. 通过上面的按钮安装

为什么选择USB网络？

• ✅ 通过USB快速离线访问
• ✅ 无需订阅
• ✅ 简单--只需在存储设置中启用

📋 Manual USB Web Configuration

添加 .vscode/mcp.json:

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

故障排除：

• 确保您的reMarkable已通过USB连接并解锁
• 验证USB web界面是否在设置中启用→ 存储
• 平板电脑应可在以下位置访问 http://10.11.99.1

______________________________________________________________________

⚡ SSH模式（高级）

适用于需要直接访问文件系统的高级用户。比USB Web更快，但需要开发人员模式（出厂重置）。

![Install SSH Mode in VS Code]() ![Install SSH Mode in VS Code Insiders]()

要求： 开发人员模式已启用 +USB连接到您的reMarkable

📋 Manual SSH Configuration

添加 .vscode/mcp.json:

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

看 SSH安装指南 详细说明。

______________________________________________________________________

☁️ 云模式（无线）

用于USB不可用时的无线或远程访问。需要可重新标记的Connect订阅，并且比USB模式慢得多。

📋 Cloud Mode Setup

1.获取一次性代码

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

2.转换为Token

uvx remarkable-mcp --register YOUR_CODE

3.安装

![Install Cloud Mode in VS Code]() ![Install Cloud Mode in VS Code Insiders]()

或在中手动配置 .vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "remarkable-token",
      "description": "reMarkable API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "google-vision-key",
      "description": "Google Vision API Key",
      "password": true
    }
  ],
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp"],
      "env": {
        "REMARKABLE_TOKEN": "${input:remarkable-token}",
        "GOOGLE_VISION_API_KEY": "${input:google-vision-key}"
      }
    }
  }
}

______________________________________________________________________

______________________________________________________________________

连接模式

选择最适合您的连接方法：

📖 详细设置指南：

• USB Web界面设置 — 推荐 --设置简单，功能齐全
• SSH安装指南 --适用于需要文件系统访问权限的高级用户
• 云设置记录在上面的快速安装部分

______________________________________________________________________

OpenClaw集成

卓越的mcp作为一个 开爪 技能。添加到您的 openclaw.json:

{
  "mcpServers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--usb"]
    }
  }
}

从以下位置安装 爪集:

clawhub install remarkable-mcp

或复制 SKILL.md 从该存储库到您的 ~/.openclaw/skills/remarkable-mcp/ 目录。

______________________________________________________________________

工具

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

📖 完整工具文档

智能功能

• 自动重定向 --浏览文档路径会自动返回其内容
• 自动OCR --没有键入文本的笔记本会自动启用OCR
• 批量搜索 --在一次通话中搜索多个文档
• 视觉支持 --获取视觉背景的页面图像（图表、模型、草图）
• OCR采样 -使用客户的AI对图像进行OCR（不需要API密钥）
• 标签支持 --按标签过滤和组织文档

示例用法

# Read a document
remarkable_read("Meeting Notes")

# Search for keywords
remarkable_read("Project Plan", grep="deadline")

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

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

# Filter by tags
remarkable_browse("/", tags=["important"])
remarkable_browse("/Work", tags=["project", "active"])

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

# Search with tag filter
remarkable_search("project", tags=["work"])

# Get recent documents
remarkable_recent(limit=10)

# Get a page image (for visual content like UI mockups or diagrams)
remarkable_image("UI Mockup", page=1)

# Get SVG for editing in design tools
remarkable_image("Wireframe", output_format="svg")

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

# Transparent background for compositing
remarkable_image("Logo Sketch", background="#00000000")

# Compatibility mode: return resource URI instead of embedded resource
remarkable_image("Diagram", compatibility=True)

______________________________________________________________________

资源

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

📖 完整资源文档

______________________________________________________________________

OCR手写

对于手写内容，卓越的mcp提供了多种OCR后端。根据您的设置和要求进行选择：

快速设置

集 REMARKABLE_OCR_BACKEND 在MCP配置中：

{
  "env": {
    "REMARKABLE_OCR_BACKEND": "sampling"
  }
}

选项： sampling, google, tesseract, auto

📖 Sampling OCR (No API Key)

使用MCP客户端的AI模型进行OCR。与支持MCP采样的客户端（VS Code+Copilot、Claude Desktop等）配合使用。

赞成的意见：

• 不需要额外的API密钥
• 质量取决于客户的型号（GPT-4、Claude等）
• 私人——手写内容仅限于您的客户

欺骗：

• 仅适用于具有采样功能的客户端
• 如果采样不可用，则返回Google Vision（如果配置了API键）或Tesseract

📖 Google Cloud Vision

提供始终如一的出色手写识别。

设置：

1. 启用 云视觉API
2. 创建一个 API密钥
3. 添加到配置： "GOOGLE_VISION_API_KEY": "your-key"

成本： 每月1000个免费请求，每1000个约1.50美元。

📖 完整的谷歌视觉设置指南

📖 Tesseract (Fallback)

为打印文本设计的开源OCR。手写效果不佳，但可用作离线回退。

# Install Tesseract
# macOS
brew install tesseract

# Ubuntu/Debian
sudo apt install tesseract-ocr

# Windows
choco install tesseract

默认行为(auto)

当 REMARKABLE_OCR_BACKEND=auto （默认）：

1. 谷歌视觉（如果 GOOGLE_VISION_API_KEY 已设置）
2. 中断（回退）

______________________________________________________________________

SSH与云比较

📖 SSH安装指南

______________________________________________________________________

高级配置

根路径过滤

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

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--ssh"],
      "env": {
        "REMARKABLE_ROOT_PATH": "/Work",
        "GOOGLE_VISION_API_KEY": "your-api-key"
      }
    }
  }
}

使用此配置：

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

适用于：

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

自定义背景颜色

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

{
  "servers": {
    "remarkable": {
      "command": "uvx",
      "args": ["remarkable-mcp", "--ssh"],
      "env": {
        "REMARKABLE_BACKGROUND_COLOR": "#FFFFFF"
      }
    }
  }
}

支持的格式：

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

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

______________________________________________________________________

用例

研究与写作

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

每日评论

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

文档搜索

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

知识管理

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

______________________________________________________________________

文档

______________________________________________________________________

发展

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

📖 开发指南

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________