rustpad-mcp

Model Context Protocol 서버로, Rustpad를 위한 것입니다. Rustpad는 효율적이고 최소한의 자체 호스팅 협업 텍스트 편집기입니다.

이 서버는 AI 어시스턴트에게 Rustpad 인스턴스의 패드에 대한 읽기 및 쓰기 접근 권한을 부여합니다. 읽기는 Rustpad의 HTTP API를 통해 이루어지며, 쓰기는 OT(Operational Transformation) 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의 특성을 명심하세요: 패드는 일시적입니다 (서버 재시작 시 손실되며, SQLITE_URI로 실행하지 않는 한 24시간 비활성 후 사라짐) 그리고 패드 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로 설정하면 처음 세 개의 도구만 등록됩니다.

안전

• 패드 내용은 전 세계에서 쓸 수 있으므로 신뢰할 수 없습니다: 모든 읽기 결과에는 모델이 이를 데이터로만 취급하고 명령어로 취급하지 않도록 하는 마커가 접두사로 붙습니다.

• 비어 있지 않은 패드를 교체하는 것은 되돌릴 수 없으며, 이전 도구 결과에만 나타나는 일회용 확인 토큰으로 보호됩니다.

• 도구 결과는 크기가 제한됩니다; 업스트림 오류 본문은 모델에 도달하기 전에 정리됩니다.

• 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, 증명 포함)을 통해 npm에 게시하고, 멀티 아키텍처 컨테이너 이미지를 GHCR에 푸시하며, CHANGELOG 섹션에서 GitHub 릴리스를 생성하고, 공식 MCP 레지스트리의 항목을 업데이트합니다.

라이선스

MIT © Willi Thiel