rustpad-mcp

Model Context Protocol サーバー for Rustpad。効率的で最小限、セルフホスト型のコラボレーティブテキストエディタです。

AIアシスタントにRustpadインスタンスのパッドへの読み取り・書き込みアクセスを提供します。読み取りはRustpadのHTTP APIを介して行い、書き込みはオペレーショナルトランスフォーメーションのWebSocketプロトコルを使用するため、append_to_document や replace_in_document といったターゲットを絞った編集が、人間の共同編集者が同時に入力する内容と上書きではなく、きれいにマージされます。サーバーがパッドを編集している間、そのパッド内の全ユーザーには rustpad-mcp という名前の共同編集者として表示されます。

📖 完全なドキュメントは rustpad-mcp.ni-c.de で

要件

• 到達可能なRustpadインスタンス（セルフホスト型。サーバーはステートレスで認証情報は不要 — Rustpadに認証機能はありません）

• Node.js >= 22、またはDocker

Related MCP server: SSH MCP Server

設定

同じURLがHTTP API、WebSocketエンドポイント、およびツールが返す共有リンク（<RUSTPAD_URL>/#<pad-id>）に使用されます。ブール値は正確に true でなければなりません。サーバーは設定なしで起動し、ツールをリスト表示します。その後の呼び出しはすべてセットアップ手順を示して失敗します。

Rustpadの性質を理解しておいてください：パッドは一時的（サーバー再起動時および24時間非アクティブ状態が続くと失われます。ただし、インスタンスが SQLITE_URI で実行されている場合は除く）であり、パッドIDを知っている人は誰でも読み書きできます。パッドに機密情報を入れないでください。

インストール

Claude Code

claude mcp add rustpad --env RUSTPAD_URL=https://rustpad.example.net -- npx rustpad-mcp

Claude Desktop

{
  "mcpServers": {
    "rustpad": {
      "command": "npx",
      "args": ["rustpad-mcp"],
      "env": {
        "RUSTPAD_URL": "https://rustpad.example.net"
      }
    }
  }
}

Codex

~/.codex/config.toml:

[mcp_servers.rustpad]
command = "npx"
args = ["-y", "rustpad-mcp"]

[mcp_servers.rustpad.env]
RUSTPAD_URL = "https://rustpad.example.net"

Docker

docker run -i --rm -e RUSTPAD_URL=https://rustpad.example.net ghcr.io/ni-c/rustpad-mcp

ツール

RUSTPAD_READ_ONLY=true の場合、最初の3つのみが登録されます。

安全性

• パッドのコンテンツは全世界から書き込み可能であり、信頼できません。すべての読み取り結果には、モデルに対してそれをデータとして扱い、決して指示として扱わないように伝えるマーカーが先頭に付加されます。

• 空でないパッドの置き換えは元に戻せず、以前のツール結果にのみ表示される使い捨ての確認トークンによって保護されています。

• ツールの結果はサイズ制限があります。上流のエラーボディはモデルに到達する前にサニタイズされます。

• RUSTPAD_INSECURE_TLS は、設定された接続に対してのみ証明書検証を緩和し、プロセス全体には影響しません。

開発

npm install
npm run lint && npm run build && npm test

テストスイートは、実際のMCPプロトコルを介してrustpad-serverのインメモリフェイク（同時編集のOT変換を含む）と通信します。ライブインスタンスは必要ありません。アーキテクチャ図とソーシャルカードは生成されます — docs/assets/architecture.source.svg を編集し、npm run assets を実行してください。レンダリングされたコピーは編集しないでください。

リリース

リリースはタグ駆動です。package.json のバージョンを上げ、CHANGELOG.md の [Unreleased] ノートを新しいバージョンの下に移動し、コミットしてから:

git tag -s vX.Y.Z -m "vX.Y.Z"
git push origin main vX.Y.Z

リリースワークフローは、Trusted Publishing（OIDC、provenance付き）を介してnpmに公開し、マルチアーキテクチャコンテナイメージをGHCRにプッシュし、CHANGELOGセクションからGitHubリリースを作成し、公式MCPレジストリのエントリを更新します。

ライセンス

MIT © Willi Thiel