SafeGrd MCP server
Commit 8 Nov 2026Mengotomatiskan backup terenkripsi dan pengujian integritas untuk database, struktur direktori, dan mailbox IMAP dengan S3-compatible object locking.
Juga dikenal sebagai safegrd/cli, cli
- Stars
- 0
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.0.29
- Commit terakhir
- 8 Nov 2026
- Lisensi
- —
Apa itu SafeGrd MCP?
Mengotomatiskan backup terenkripsi dan pengujian integritas untuk database, struktur direktori, dan mailbox IMAP dengan S3-compatible object locking.
Ringkasan dibuat dari README proyek
Tentang SafeGrd MCP server
SafeGrd menyediakan sistem otomatis untuk membuat backup terenkripsi dan melakukan pengujian integritas untuk berbagai sumber data. Tool ini mendukung database PostgreSQL, MySQL, MariaDB, MongoDB, dan SQLite, serta struktur direktori dan mailbox IMAP. Tool ini mengompresi data dengan zstd dan mengenkripsinya menggunakan age langsung di host sebelum dikirim ke penyimpanan S3-compatible dengan fitur Object Lock yang aktif. Hal ini memastikan data terlindungi dari penghapusan atau modifikasi oleh agent yang tidak berwenang.
Pengguna dapat mengelola tugas-tugas ini melalui CLI atau daemon. Sistem ini memungkinkan manajemen key yang fleksibel, di mana Anda dapat memilih untuk menyimpan encryption key secara lokal atau membiarkan server remote menyimpannya dalam status sealed untuk host yang terdaftar. Untuk verifikasi, fitur Fire Drill melakukan restore backup ke dalam environment sementara untuk memvalidasi bahwa setiap tabel, baris, dan file tetap utuh. Setup ini dirancang untuk developer dan system administrator yang membutuhkan perlindungan data yang andal dan dapat diverifikasi untuk environment produksi.
Apa yang bisa Anda lakukan dengannya
- 1Verifikasi integritas backupJalankan Fire Drill untuk me-restore backup ke dalam database sementara dan pastikan semua baris serta tabel sudah benar.
- 2Lindungi command yang bersifat destruktifEksekusi command berbahaya hanya setelah snapshot yang terkunci berhasil dibuat.
- 3Lakukan incremental file backupBackup struktur direktori di mana hanya bagian (chunk) yang berubah saja yang diunggah setelah proses bulanan pertama.
- 4Restore file spesifikAmbil satu versi dari file tertentu dari snapshot sebelumnya tanpa harus me-restore seluruh dataset.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal SafeGrd MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal SafeGrd MCP di Claude Code
$ claude mcp add cli -- docker run -i --rm ghcr.io/safegrd/cli:0.0.29Instal SafeGrd MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/safegrd/cli:0.0.29"
]
}
}
}Instal SafeGrd MCP di VS Code
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/safegrd/cli:0.0.29"
]
}
}
}Instal SafeGrd MCP di VS Code CLI
$ code --add-mcp '{"name":"cli","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/safegrd/cli:0.0.29"]}'Instal SafeGrd MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cli": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/safegrd/cli:0.0.29"
]
}
}
}Instal SafeGrd MCP di Codex
$ codex mcp add cli -- docker run -i --rm ghcr.io/safegrd/cli:0.0.29Instal SafeGrd MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.cli] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/safegrd/cli:0.0.29"]
Instal SafeGrd MCP di Gemini CLI
$ gemini mcp add -s user cli docker -- run -i --rm ghcr.io/safegrd/cli:0.0.29Instal SafeGrd MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/safegrd/cli:0.0.29"
]
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkausafegrd/cli is public and reachablegithub.com/safegrd/cli ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-08github.com/safegrd/cli ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPHTTPS endpoint answered 401 (sign-in required)Lolos
README
Lihat di GitHubSafeGrd CLI (safegrd)
safegrd backs up PostgreSQL, MySQL, MariaDB, MongoDB and SQLite databases, directory trees
and IMAP mailboxes. Each backup is compressed with zstd and encrypted with age on the host that
takes it, then written to S3-compatible storage under Object Lock. It is restored on a schedule
to check that every table, row and file came back.
It is the CLI and daemon of SafeGrd. Documentation is at safegrd.dev/docs, and every command and flag is in the command reference.
- Backups go from your host straight to storage. The remote server receives a record of each backup (when it ran, its size, its digest and the date its lock ends) and the signed result of each restore test. The data never passes through it.
- You choose who holds the key. By default the remote server keeps your key sealed and
releases it only to your enrolled hosts, so you can restore even after losing a host. With
enroll --key-custody local, only you can decrypt these backups. - Restores are tested. A Fire Drill restores the newest backup into a throwaway database or directory, compares its tables, rows and digests with what was backed up, and signs the result.
- An agent cannot remove a backup.
safegrd guardtakes a locked snapshot before a destructive command runs, and a personal access token cannot delete a backup or shorten its lock.
Installation
Install script (Linux and macOS)
curl -fsSL https://safegrd.dev/install.sh | sh
It detects your OS and architecture, downloads the matching release archive, checks
it against the release's checksums.txt, and installs safegrd to /usr/local/bin
(or ~/.local/bin when it cannot use sudo). The script is install.sh
in this repository; https://raw.githubusercontent.com/safegrd/cli/main/install.sh
serves the same file.
When it runs in a terminal, it then offers to connect the machine to a remote server:
a browser login, a question about who holds the encryption key, then safegrd enroll.
The login prints a URL and a code that you can open in a browser on any device, so
it works the same on a server you reached over SSH or PuTTY. Without a terminal (CI,
cloud-init, cron) it installs and stops.
Options are environment variables, and they go on the sh after the pipe. Written
before curl they apply to curl, and the script never sees them:
curl -fsSL https://safegrd.dev/install.sh | VERSION=v0.0.3 sh # pin a release
curl -fsSL https://safegrd.dev/install.sh | SAFEGRD_INSTALL_DIR=~/.local/bin sh # no sudo
curl -fsSL https://safegrd.dev/install.sh | SAFEGRD_NO_SETUP=1 sh # install only
| Variable | Effect |
|---|---|
VERSION |
Release tag to install. Default: the latest release. |
SAFEGRD_INSTALL_DIR |
Where the binary goes. |
SAFEGRD_NO_SETUP=1 |
Install only; do not offer to log in and enroll. |
SAFEGRD_FORCE_INSTALL=1 |
Download and install even when the release asked for is already installed. |
SAFEGRD_PROJECT |
Project ID or slug to enroll this machine into. |
SAFEGRD_STORAGE |
hosted or local: where backups go when the project has no bucket. |
SAFEGRD_CLAIM |
The claim code the console shows for this machine. It carries the project, where backups go and the surfaces to protect, so enrollment writes them into the config and asks nothing. Needs a release whose enroll has --claim; an older one stops and says so. |
SAFEGRD_NODE_NAME |
Name the machine is shown under. |
SAFEGRD_KEY_CUSTODY |
local keeps this host's key on the host. Without it the remote server keeps the key sealed and releases it only to your enrolled hosts. |
SAFEGRD_SERVER_URL |
Remote server to log in and enroll with. Default: https://safegrd.dev. |
Homebrew (macOS and Linux)
brew install safegrd/tap/safegrd
The formula installs the same release archives as the script.
Go
go install github.com/safegrd/cli/cmd/safegrd@latest
Container image
ghcr.io/safegrd/cli runs on linux/amd64 and linux/arm64 and carries pg_dump, mysqldump
and mongodump, and a PostgreSQL 18 server so a drill can restore a database into a
throwaway cluster on the volume. The tag names the Postgres client: <version>-pg18 reads
Postgres 18 and every older server. Releases are signed with cosign (keyless, from this repository's release
workflow):
cosign verify ghcr.io/safegrd/cli:<version>-pg18 \
--certificate-identity-regexp 'https://github.com/safegrd/cli/.github/workflows/release.yml@.*' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
packaging/compose runs the daemon beside a database,
packaging/kubernetes runs daemon run --once as a
CronJob, and packaging/helm/safegrd runs the daemon as a
Deployment.
Each names the release it was cut with, such as ghcr.io/safegrd/cli:0.0.10; change
the tag to upgrade.
Release archives, or from source
Static binaries for Linux and macOS (amd64, arm64) and their SHA-256 checksums are
on the releases page. To build:
git clone https://github.com/safegrd/cli.git && cd cli
make build
Try it before you sign up
With no account, one command backs up a database and restores it to check:
safegrd try postgres://app:secret@db.example.com/app # or env:DATABASE_URL, a MySQL, MongoDB or SQLite URL, or a directory
safegrd signup # keep it: the host, its backup and a daily schedule
The backup is encrypted on this host, stored on the remote server's storage for 24 hours, and restored in memory from there. Details are in the install guide.
Quickstart
1. Create a config and a key
Skip this if you let the install script connect the machine: it already wrote the
keypair and ~/.safegrd/config.yaml, and init refuses to overwrite them.
# writes an age X25519 keypair and ~/.safegrd/config.yaml
safegrd init \
--database-url "postgres://postgres:password@localhost:5432/myapp_prod" \
--storage local \
--local-path ./backups \
--retention-days 14
2. Connect to a remote server (optional)
# Prints a URL and a code: open it in a browser on any device, including over SSH
safegrd login
# Register this machine, generating its encryption key if it has none.
# --key-custody decides whether the server keeps a copy (safegrd) or not (local)
safegrd enroll --key-custody local
# A host that should encrypt but never decrypt: make the key pair on your laptop,
# then put only the printed public key in the host's encryption.public_key
safegrd keygen --out ~/.safegrd/keys/prod.key
# Headless / CI: a Personal Access Token instead of the browser
safegrd enroll --token "sg_pat_..."
# Or with the claim code the console's setup shows: the project, where backups go and
# the surfaces are written into ~/.safegrd/config.yaml, and the key stays on this machine
safegrd enroll --claim <code>
safegrd doctor # every surface opens from this host; the console shows the result
safegrd daemon run --once
# Later, on an enrolled host: add the surfaces named for it in the console
# (Add surface on its row). Only adds; the old config is kept as config.yaml.bak
safegrd claim
safegrd daemon restart
# Verify the active session
safegrd whoami
3. Back up
# dumps, compresses, encrypts with age on this host, and writes to locked storage
safegrd backup
4. Run a Fire Drill
# restores into an empty database and checks every table's row count
safegrd verify \
--snapshot snap-20260919-01 \
--sandbox-target "postgres://postgres:password@localhost:5432/ephemeral_test_db"
5. Restore
safegrd restore \
--snapshot snap-20260919-01 \
--target "postgres://postgres:password@localhost:5432/myapp_recovered"
6. Protect several things on one host, unattended
Each entry under surfaces: in ~/.safegrd/config.yaml is one protected thing, and
safegrd daemon install runs them on their schedules. A surface's credential block says
where its secret comes from; the config never holds it:
surfaces:
- id: app-primary
type: postgres
schedule: "@daily"
credential:
from: env # or: command (with run), file (with path),
name: APP_DATABASE_URL # or safegrd: the remote server holds it for this host
- id: user-uploads
type: files
schedule: "6h"
roots: ["/var/www/uploads"]
safegrd.example.yaml is the annotated version. The daemon reads its
config when it starts, so run safegrd daemon restart after changing it.
7. Take a locked snapshot before a destructive command
safegrd guard backs up one surface, waits until the snapshot is uploaded and locked, and
then runs the command. If the backup fails or the snapshot is not locked, the command does
not run and guard exits 3.
safegrd guard --surface app-primary -- psql "$APP_DATABASE_URL" -c 'DROP TABLE sessions'
safegrd guard -- terraform destroy
# The commands a hook treats as destructive, and a check that takes no backup
safegrd guard --list
safegrd guard --matches "npx prisma migrate reset" # exit 0: it matches
Storage on the host's own disk, or a bucket with worm_mode: NONE, cannot lock a snapshot,
so guard refuses there unless you pass --allow-unlocked.
A locked snapshot of the surface younger than --max-age stands in for a new backup, so an
agent running several destructive commands in a row backs up once. --check-only takes no
backup at all and refuses the command unless such a snapshot exists:
safegrd guard --max-age 30m -- psql "$APP_DATABASE_URL" -c 'TRUNCATE sessions'
safegrd guard --max-age 1h --check-only -- terraform destroy
safegrd list --json prints every snapshot with its lock date, for scripts.
8. Back up a directory tree, and get one file back
File backups are incremental: the first run of each month uploads every file, and every run after it uploads only the chunks that changed. Every kept version of every file is searchable, and one file restores on its own.
safegrd backup --files /srv/app --exclude '*.tmp,node_modules/*'
# every kept version of a file, numbered from the oldest
safegrd find etc/nginx/nginx.conf
# one version of one file, or a directory as it was in one snapshot
safegrd restore --path etc/nginx/nginx.conf --version 2 --target-dir ./out
safegrd restore --snapshot snap-20260919-01 --path 'var/www/**' --target-dir ./out
# every pack present and every listing consistent, without restoring anything
safegrd check --all
# a bucket over the S3 API (Supabase Storage, or any S3-compatible store)
safegrd backup --files s3://avatars --source-endpoint https://PROJECT.storage.supabase.co/storage/v1/s3 \
--source-region eu-central-1 --source-access-key env:S3_KEY --source-secret-key env:S3_SECRET
# and back into the bucket, each object with the content type it had
safegrd restore --snapshot snap-20261012-01 --target s3://avatars --source-endpoint https://PROJECT.storage.supabase.co/storage/v1/s3 \
--source-region eu-central-1 --source-access-key env:S3_KEY --source-secret-key env:S3_SECRET
--format tar keeps one archive per backup instead. What is locked, for how long, and
what a restore brings back: safegrd.dev/docs/surfaces/files.
AI agents (MCP)
safegrd has two MCP servers. Neither has a tool that deletes a backup, changes where
backups go, or takes a private key.
The local server, safegrd mcp, runs on a host over stdio and uses that host's config
and key. Its tools are status, list, doctor, backup, verify, restore and
export, each running the command of the same name. restore writes only into a new or
empty directory or an empty database.
claude mcp add safegrd-local -- safegrd mcp
# a host that runs the container image: mount the volume it enrolled with
claude mcp add safegrd-local -- docker run -i --rm \
-v safegrd:/home/safegrd/.safegrd ghcr.io/safegrd/cli mcp
The remote server, https://safegrd.dev/mcp, reads every host's backups and Fire Drills
and asks for a backup or a drill now, on every plan. Add it with no header, then run /mcp
in Claude Code and choose Authenticate: you sign in to SafeGrd in the browser and approve.
claude mcp add --transport http safegrd https://safegrd.dev/mcp
The Claude Code plugin in safegrd/agent-plugins adds the same server, signed in the same way, with skills that back up and run a Fire Drill before a risky change:
/plugin marketplace add safegrd/agent-plugins
/plugin install safegrd@safegrd
A client that cannot sign in, such as CI, sends a personal access token from the console's
Tokens page as Authorization: Bearer sg_pat_....
Both servers are listed in the MCP Registry
as dev.safegrd/safegrd, and the remote one on Smithery.
Cursor and VS Code configs, and every tool's arguments: safegrd.dev/docs/mcp.
What it backs up
- PostgreSQL, incrementally: the schema comes from
pg_dumpand the rows stream over binaryCOPYfrom the same snapshot, so arrays, enums, foreign keys, views, triggers and sequence positions all come back. Each run uploads only the chunks of each table that changed,restore --tableloads chosen tables into a running database, and--change-logskips reading tables nothing wrote since the last run.--format tarkeeps one archive per backup. Needs apg_dumpat least as new as the server on the host. - SQLite, incrementally: copied through SQLite's online backup in one read transaction, so transactions still in the WAL are in it and writers carry on. The copy keeps the database's pages in place, so each run uploads only the chunks whose pages changed.
--format tarkeeps one archive per backup. Needs nothing installed on the host. - MySQL and MariaDB through
mysqldump --single-transaction, and MongoDB throughmongodump --archive, one archive per backup. - Directory trees, incrementally: each run uploads only the chunks that changed, every object is locked once when it is written, and
safegrd findlists every kept version of a file forrestore --path --version. - IMAP mailboxes, every message as RFC 5322 mail, checked by SHA-256 on every drill.
- Locked storage: S3 Object Lock in compliance mode, or governance mode where a lock may need lifting. Storage on the host's own disk, and a bucket with
worm_mode: NONE, keep backups without a lock. - Fire Drills: restore backups on a schedule, count what came back, and sign a record of each test.
Development
Go 1.25 or newer. make with no target lists everything.
make build # compile bin/safegrd
make test # unit and integration tests, race detector
make ci # the exact gate CI runs: gofmt check, tidy check, vet, race tests
make dist # cross-compile release archives + checksums into dist/
make fmt tidy # the developer-facing fixers (these rewrite files; `ci` never does)
CI runs make ci on every push and pull request, so a green local run means a
green pipeline. Tagging v* runs make dist VERSION=<tag without v> and
publishes the archives and checksums.txt as a GitHub Release.
License
Business Source License 1.1, with an Additional Use Grant. See LICENSE.
In short: read, modify and build it freely, and use it for evaluation anywhere. Production use is included with a SafeGrd account on any plan, the free one too. Listing, verifying, restoring and exporting your backups is always permitted, with or without an account. Each version becomes GPL-3.0-or-later four years after it is published. For a commercial license, contact support@safegrd.dev.
Pertanyaan tentang SafeGrd MCP
Bagaimana cara menambahkan SafeGrd MCP ke Claude Code?
Jalankan claude mcp add cli -- docker run -i --rm ghcr.io/safegrd/cli:0.0.29 di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan SafeGrd MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah agent bisa menghapus backup?
Tidak, sistem dirancang sedemikian rupa sehingga agent atau personal access token tidak dapat menghapus backup atau memperpendek masa lock-nya.
Bagaimana cara mengamankan backup?
Backup dikompresi dengan zstd dan dienkripsi menggunakan age di host sebelum ditulis ke penyimpanan S3-compatible di bawah Object Lock.
Apa itu Fire Drill?
Fire Drill adalah uji restore yang memulihkan backup terbaru ke dalam environment sementara untuk memverifikasi bahwa semua tabel, baris, dan file dalam kondisi utuh.
Apakah server remote bisa melihat data saya?
Tidak, data dienkripsi di host Anda dan dikirim langsung ke penyimpanan; server remote hanya menerima metadata dan hasil uji restore.