supernote-mcpとは？
GitHubユーザーridgetによるsupernote-mcpは、同じWi-Fiネットワーク上の電子ペーパー端末Ratta SupernoteにMCPクライアントをつなぎます。書いている最中の画面をそのまま取り込み、ファイルを一覧にし、ノートの手書き認識結果をテキストで、あるいはページを画像で返し、端末との間でファイルをコピーします。使うのは端末に元からある2つの機能で、ポート8080のScreen Mirroringと、ポート8089のファイルサーバーBrowse & Accessです。
MITライセンスのTypeScriptで書かれ、npmと5つのプラットフォーム向けの単体バイナリで配布されています。GitHubのスターは約2です。2026年9月22日公開のバージョン0.2.3でダウンロード用のツールが加わりました。Rattaとは関係がありません。
supernote-mcpのインストール方法
npx -y supernote-mcpsupernote-mcpは使う価値があるか？
supernote-mcpができることは6つで、どれも飾り気なくこなします。supernote_snapshotは現在の画面をPNGで返し、一覧、読み取り、描画のツールは保存済みのノートをたどり、アップロードとダウンロードはファイルを移します。ノートを読むと端末自身の手書き認識の結果がテキストで返り、画像よりモデルの負担がずっと軽くなります。描画は1回の呼び出しで20ページまでです。どのツールも10秒でタイムアウトし、考えられる原因を示すメッセージを返します。また、呼び出されるまで端末には一切触れません。
頼っている2つのインターフェースはどちらもリバースエンジニアリングで得たもので、READMEもそう書いています。画面ミラーとBrowse & Accessはプログラム向けに文書化されておらず、ファームウェアの更新で変わったり壊れたりす る可能性があります。Rattaのサポートページは、Browse & Accessを同じWi-Fi上のブラウザで開くファイルサーバーとして説明しており、そのページもREADMEもパスワードやPINには触れていません。どちらにも端末が接続相手を制限することを示す記述はないため、切り替えがオンの間は、画面やファイルがそのネットワーク上の誰にでも開かれていると考えてください。
注意点：エージェントは双方向のファイルアクセスを得ます。supernote_upload_fileはサーバーのプロセスが読めるローカルファイルなら何でも送り、supernote_download_fileはローカルのパスに書き込みます。既定は$TMPDIRです。設定したアドレスにつながらないと、サーバーは端末を探すためにサブネット全体をポート8080で走査します。社内ネットワークではこの走査自体が警報を鳴らすことがあり、SUPERNOTE_DISCOVER=0で止められます。パソコン側のVPNやプロキシは接続を壊します。
結論：紙の感覚で計画を立て、書き出しをせずにスケッチをチャットに持ち込みたいSupernoteの持ち主にとって、これが最短の道で、設定は2つの切り替えとIPアドレスだけです。端末の機能はそのセッションの間だけオンにし、大きなファームウェア更新の後は、ただ1人の開発者が追いつくまで使えない期間があると考えておくべきです。
真価を発揮する場面
会議中にSupernote Mantaで画面の流れを描くプロダクトマネージャー
今日の午後に描いたスケッチを文章の仕様書にしたい
Screen Mirroringをオンにし、エージェントに画面のスナップショットを撮らせ、その画像から仕様書の下書きを作らせます。無料で、スナップショット1枚がモデルの文脈の画像1枚になります。
Nomadに1学期分の講義ノートをためた大学院生
試験の前に、あるテーマについてのノートを要約したい
Browse & Accessを開き、エージェントに/Noteを一覧させてから、該当するノートをsupernote_read_noteでテキストとして読ませます。認識済みテキストのないノートは、1回20ページまでの描画済みページに切り替わります。
端末でPDFに書き込みをする弁護士
下書きをSupernoteに送り、書き込み済みの版を取り戻したい
supernote_upload_fileでPDFを送り、端末で書き込んでから、supernote_download_fileで取り出します。オフィスの共用Wi-Fiでは、使わないときはBrowse & Accessをオフにしておきます。
導入前に確認すること
- 導入
- 端末でScreen MirroringかBrowse & Accessをオンにして IPアドレスを控え、SUPERNOTE_IPを設定してclaude mcp addでnpx -y supernote-mcpを登録します。Node.js 18+、Bun、または単体バイナリが必要です。DHCPの予約でIPを固定できます。
- 連携
- Screen Mirroringに対応したSupernote端末（Manta、Nomad、A5X、A6Xの系統）。画面の取り込みと.noteの解析にはsupernote-typescriptライブラリを使います。stdio対応のあらゆるMCPクライアント。
- データとプライバシー
- stdio経由でローカルに動きます。画面の画像、ノートのテキスト、ファイルの中身はモデル提供元に送られます。端末のミラー（ポート8080）とファイルサーバー（ポート8089）は、オンの間はローカルネットワークから到達できます。アップロードはサーバーが読めるローカルファイルなら何でも読みます。
- 大規模利用時のコスト
- MITのもとで無料です。費用は端末代だけです。
- 制限
- 同じWi-Fiネットワークで、VPNやプロキシなしで使う必要があります。非公開のインターフェースはファームウェア更新で壊れる可能性があります。描画は20ページまでで、呼び出しは10秒でタイムアウトします。
良い点
- 手書き認識の結果を画像だけでなくテキストで読める
- 10秒のタイムアウトとわかりやすいエラーメッセージ
- npm、Bun、単体バイナリでインストール可能
- ツールを呼び出したときだけ端末に触れる
気になる点
- リバースエンジニアリングによる非公開のインターフェースに依存
- 端末のミラーとファイルサーバーはパスワードを求めない
- 予備の探索はサブネット全体を走査する
- 開発者は1人で、スターは約2
おすすめの人
計画や会議の最中に手書きし、そのページをエージェントに読ませたいSupernote Manta、Nomad、A5X、A6Xの持ち主。
supernote-mcp：よくある質問
- supernote-mcpは使う価値があるか？
- Supernoteの手書きをエージェントとの会話で役立てる、すっきりした範囲の狭い橋 渡しですが、次のファームウェア更新で変わりうる文書化されていないインターフェースに頼っています。 評価は5点満点中3.6点です。
- supernote-mcpの料金は？
- 無料のオープンソース（MIT）。Screen MirroringまたはBrowse & Accessに対応したSupernoteが必要です。
- supernote-mcpの欠点は？
- リバースエンジニアリングによる非公開のインターフェースに依存; 端末のミラーとファイルサーバーはパスワードを求めない; 予備の探索はサブネット全体を走査する; 開発者は1人で、スターは約2.
- supernote-mcpは誰に向いているか？
- 計画や会議の最中に手書きし、そのページをエージェントに読ませたいSupernote Manta、Nomad、A5X、A6Xの持ち主。
- チームや本番環境でsupernote-mcpを使うと費用はいくらか？
- MITのもとで無料です。費用は端末代だけです。
- supernote-mcpは企業データを扱っても安全か？
- stdio経由でローカルに動きます。画面の画像、ノートのテキスト、ファイルの中身はモデル提供元に送られます。端末のミラー（ポート8080）とファイルサーバー（ポート8089）は、オンの間はローカルネットワークから到達できます。アップロードはサーバーが読めるローカルファイルなら何でも読みます。
回答確認日：2026年11月14日