rustpad-mcp

Un servidor del Protocolo de Contexto de Modelo para Rustpad, el editor de texto colaborativo eficiente, mínimo y auto-alojado.

Proporciona a un asistente de IA acceso de lectura y escritura a los pads de una instancia de Rustpad. Las lecturas se realizan a través de la API HTTP de Rustpad; las escrituras utilizan el protocolo WebSocket de transformación operacional, por lo que las ediciones dirigidas (append_to_document, replace_in_document) se fusionan limpiamente con lo que los colaboradores humanos escriben al mismo tiempo, en lugar de sobrescribirlo. Mientras el servidor edita un pad, es visible para todos en el pad como un colaborador llamado rustpad-mcp.

📖 Documentación completa en rustpad-mcp.ni-c.de

Requisitos

• Una instancia de Rustpad accesible (auto-alojada; el servidor no tiene estado y no necesita credenciales — Rustpad no tiene autenticación)

• Node.js >= 22, o Docker

Related MCP server: SSH MCP Server

Configuración

La misma URL sirve la API HTTP, el endpoint WebSocket y los enlaces de uso compartido devueltos por las herramientas (<RUSTPAD_URL>/#<pad-id>). Los valores booleanos deben ser exactamente true. El servidor se inicia y lista sus herramientas sin configuración; cada llamada falla entonces con instrucciones de configuración.

Ten en cuenta qué es Rustpad: los pads son efímeros (se pierden al reiniciar el servidor y después de 24 horas de inactividad, a menos que la instancia se ejecute con SQLITE_URI) y cualquiera que conozca un id de pad puede leerlo y escribirlo. No pongas secretos en los pads.

Instalación

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

Herramientas

Con RUSTPAD_READ_ONLY=true solo se registran las tres primeras.

Seguridad

• El contenido del pad es escribible por cualquier persona y, por lo tanto, no es de confianza: cada resultado de lectura va precedido de un marcador que indica al modelo que lo trate como datos, nunca como instrucciones.

• Reemplazar un pad no vacío es irreversible y está protegido por un token de confirmación de un solo uso que solo aparece en un resultado de herramienta anterior.

• Los resultados de las herramientas tienen un límite de tamaño; los cuerpos de error ascendentes se sanitizan antes de llegar al modelo.

• RUSTPAD_INSECURE_TLS relaja la validación del certificado solo para la conexión configurada, nunca a nivel de proceso.

Desarrollo

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

El conjunto de pruebas se comunica con un simulacro en memoria del servidor rustpad (incluyendo la transformación OT de ediciones concurrentes) a través del protocolo MCP real; no se necesita una instancia en vivo. El diagrama de arquitectura y la tarjeta social se generan — edita docs/assets/architecture.source.svg y ejecuta npm run assets, nunca las copias renderizadas.

Publicación de versiones

Las versiones se basan en etiquetas. Actualiza package.json, mueve las notas [Unreleased] en CHANGELOG.md bajo la nueva versión, haz commit, luego:

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

El flujo de trabajo de publicación publica en npm mediante Trusted Publishing (OIDC, con procedencia), envía la imagen de contenedor multiarquitectura a GHCR, crea el lanzamiento de GitHub a partir de la sección de CHANGELOG y actualiza la entrada en el registro oficial de MCP.

Licencia

MIT © Willi Thiel