Remarkable MCP

🚀 reMarkable MCP 服務器

將你的 reMarkable 平板電腦解鎖為人工智能助手的第二大腦。這個 MCP 服務器允許 Claude、VS Code Copilot 等人工智能工具讀取、搜索和遍歷你整個 reMarkable 文庫，包括通過 OCR 識別的手寫筆記。

🚀 快速開始

為什麼選擇 remarkable-mcp？

你的 reMarkable 平板電腦是思考、記筆記和研究的強大工具。但這些知識被困在了設備上。這個 MCP 服務器改變了這一現狀：

• 全文庫訪問 — 瀏覽文件夾、搜索文檔、讀取任何文件
• 打字文本提取 — 原生支持 Type Folio 和打字註釋
• 手寫 OCR — 將手寫筆記轉換為可搜索的文本
• PDF 和 EPUB 支持 — 從文檔中提取文本，以及你的註釋
• 智能搜索 — 在整個文庫中查找內容
• 第二大腦集成 — 可與 Obsidian、筆記應用程序或任何人工智能工作流程配合使用

無論你是在進行研究、寫作還是開發創意，remarkable-mcp 都能讓你通過人工智能充分利用 reMarkable 上的所有內容。

⚡ 快速安裝

SSH 模式（推薦）

通過 USB 直接連接，實現快 10 - 100 倍的訪問速度，支持離線操作，且無需訂閱。

要求：啟用開發者模式 並通過 USB 連接到你的 reMarkable。

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

☁️ 雲模式（替代方案）

如果你無法啟用開發者模式，可以使用雲 API。需要 reMarkable Connect 訂閱。

uvx remarkable-mcp --register YOUR_CODE

{
  "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}"
      }
    }
  }
}

✨ 主要特性

工具

所有工具均為只讀，並返回帶有下一步操作提示的結構化 JSON。

📖 完整工具文檔

智能特性

• 自動重定向 — 瀏覽文檔路徑會自動返回其內容
• 自動 OCR — 沒有打字文本的筆記本會自動啟用 OCR
• 批量搜索 — 一次調用即可在多個文檔中搜索
• 視覺支持 — 獲取頁面圖像以提供視覺上下文（圖表、模型、草圖）
• 採樣 OCR — 使用客戶端的人工智能進行圖像 OCR（無需 API 密鑰）

資源

文檔會自動註冊為 MCP 資源：

📖 完整資源文檔

手寫 OCR

對於手寫內容，remarkable-mcp 提供了幾種 OCR 後端。可根據你的設置和需求進行選擇：

快速設置

在你的 MCP 配置中設置 REMARKABLE_OCR_BACKEND：

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

選項：sampling、google、tesseract、auto

# 安裝 Tesseract
# macOS
brew install tesseract

# Ubuntu/Debian
sudo apt install tesseract-ocr

# Windows
choco install tesseract

默認行為 (auto)

當 REMARKABLE_OCR_BACKEND = auto（默認）時：

1. 使用 Google Vision（如果設置了 GOOGLE_VISION_API_KEY）
2. 回退到 Tesseract

SSH 與雲模式對比

📖 SSH 設置指南

💻 使用示例

基礎用法

# 讀取文檔
remarkable_read("Meeting Notes")

# 搜索關鍵詞
remarkable_read("Project Plan", grep="deadline")

# 為手寫筆記啟用 OCR
remarkable_read("Journal", include_ocr=True)

# 瀏覽你的文庫
remarkable_browse("/Work/Projects")

# 在多個文檔中搜索
remarkable_search("meeting", grep="action items")

# 獲取最近的文檔
remarkable_recent(limit=10)

# 獲取頁面圖像（用於 UI 模型或圖表等視覺內容）
remarkable_image("UI Mockup", page=1)

# 獲取 SVG 格式以便在設計工具中編輯
remarkable_image("Wireframe", output_format="svg")

# 獲取帶有 OCR 文本提取的圖像（如果配置了則使用採樣）
remarkable_image("Handwritten Notes", include_ocr=True)

# 透明背景以便合成
remarkable_image("Logo Sketch", background="#00000000")

# 兼容模式：返回資源 URI 而不是嵌入式資源
remarkable_image("Diagram", compatibility=True)

📚 詳細文檔

高級配置

根路徑過濾

將 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 之外的文檔無法訪問

適用於：

• 在辦公時間專注於工作文檔
• 分離個人和專業筆記
• 為特定的人工智能工作流程限定範圍

自定義背景顏色

設置圖像渲染的默認背景顏色：

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

支持的格式：

• #RRGGBB — RGB 十六進制（例如，#FFFFFF 表示白色）
• #RRGGBBAA — RGBA 十六進制（例如，#00000000 表示透明）

默認值為 #FBFBFB（reMarkable 紙張顏色）。這會影響 remarkable_image 工具和圖像資源。

使用案例

研究與寫作

在使用 Obsidian 庫或類似工具時使用 remarkable-mcp，將手寫筆記中的知識轉化為結構化文檔。人工智能可以讀取你的研究筆記並幫助你拓展思路。

每日回顧

讓你的人工智能助手總結你最近的筆記、查找行動項或識別日記條目中的模式。

文檔搜索

通過在整個文庫中搜索，找到那半記不清的筆記，包括手寫內容。

知識管理

將你的 reMarkable 視為人工智能可以訪問的第二大腦。結合 Obsidian 等工具，你可以構建強大的個人知識系統。

文檔指南

🔧 技術細節

開發

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

📖 開發指南

📄 許可證

MIT

本項目基於 rmscene、PyMuPDF 構建，並受到 ddvk/rmapi 的啟發。