Ermöglicht es einem AI-Client, VeraCrypt-Container mittels sicherer stdin-Passwortübergabe und OS-Keyring-Integration zu mounten und zu unmounten.
Auch bekannt als bitterdev/veracrypt-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 Tage
- 152
- Neueste Version
- 0.2.0
- Letzter Commit
- 19. Okt. 2026
- Lizenz
- MIT
Was ist VeraCrypt MCP?
Ermöglicht es einem AI-Client, VeraCrypt-Container mittels sicherer stdin-Passwortübergabe und OS-Keyring-Integration zu mounten und zu unmounten.
Zusammenfassung generiert aus dem README des Projekts
Über VeraCrypt MCP server
Das Verwalten verschlüsselter VeraCrypt-Volumes über einen AI-Client erlaubt es Entwicklern, mit sensiblen Dateien per natürlicher Sprache zu interagieren. Dieser Server bietet Tools zum Mounten und Unmounten von Containern, zum Auflisten aktuell aktiver Volumes und zur Handhabung komplexer Authentifizierungsmethoden wie PIM, Read-only-Modi und Keyfiles. Sobald ein Volume gemountet ist, kann ein AI-Client Standard-File-Tools nutzen, um den Inhalt des verschlüsselten Containers zu lesen oder zu bearbeiten.
Sicherheit hat Priorität: Passwörter werden über stdin geleitet, um eine Sichtbarkeit in Prozesslisten zu vermeiden. Nutzer können macOS Keychain oder Linux libsecret integrieren, um Anmeldedaten über einen Keychain-Accountnamen abzurufen, wodurch sichergestellt wird, dass Passwörter nicht in den Chat-Logs landen. Das Setup erfordert Python 3.10 oder höher sowie das VeraCrypt Command-Line-Binary. Für macOS-Nutzer ist macFUSE eine notwendige Voraussetzung, damit der Mount-Prozess korrekt funktioniert.
Was du damit machen kannst
- 1Zugriff auf einen Standard-verschlüsselten VaultBitte die KI, einen vorkonfigurierten Container mit einem einzigen Befehl zu mounten.
- 2Mounten von Volumes mit spezifischen EinschränkungenAnweisung an die KI, einen Container im Read-only-Modus an einem bestimmten Verzeichnis zu öffnen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du VeraCrypt MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenVeraCrypt MCP in Claude Code installieren
$ claude mcp add veracrypt-mcp -- uvx veracrypt-mcpVeraCrypt MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"veracrypt-mcp": {
"command": "uvx",
"args": [
"veracrypt-mcp"
]
}
}
}VeraCrypt MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"veracrypt-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"veracrypt-mcp"
]
}
}
}VeraCrypt MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"veracrypt-mcp","type":"stdio","command":"uvx","args":["veracrypt-mcp"]}'VeraCrypt MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"veracrypt-mcp": {
"command": "uvx",
"args": [
"veracrypt-mcp"
]
}
}
}VeraCrypt MCP in Codex installieren
$ codex mcp add veracrypt-mcp -- uvx veracrypt-mcpVeraCrypt MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.veracrypt-mcp] command = "uvx" args = ["veracrypt-mcp"]
VeraCrypt MCP in Gemini CLI installieren
$ gemini mcp add -s user veracrypt-mcp uvx -- veracrypt-mcpVeraCrypt MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"veracrypt-mcp": {
"command": "uvx",
"args": [
"veracrypt-mcp"
]
}
}
}Konfiguration
VERACRYPT_MCP_CONTAINERVERACRYPT_MCP_KEYCHAIN_ACCOUNT
| Name | Beschreibung | Typ |
|---|---|---|
| VERACRYPT_MCP_CONTAINER | — | |
| VERACRYPT_MCP_KEYCHAIN_ACCOUNT | — |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarbitterdev/veracrypt-mcp is public and reachablegithub.com/bitterdev/veracrypt-mcp ↗Bestanden
- Paket nennt dieses Repository als Quelleveracrypt-mcp names bitterdev/veracrypt-mcp as sourcepypi.org/project/veracrypt-mcp/ ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-19github.com/bitterdev/veracrypt-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from veracrypt-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten29 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenveracrypt-mcp
MCP (Model Context Protocol) server for mounting and unmounting VeraCrypt containers, with a security-first approach to password handling.
Once a container is mounted, your MCP client (e.g. Claude Code) can read and edit the files inside it with its normal file tools. Say "mount my vault", work on the files, then "unmount my vault".
mcp-name: io.github.bitterdev/veracrypt-mcp
Features
- mount_container: mount a VeraCrypt container (optional mount point, PIM, read-only, keyfiles)
- unmount_container: dismount by container path or mount point
- list_mounted_containers: show all mounted VeraCrypt volumes
- Default vault: configure your container once via environment variables; "mount my vault" then works without any arguments
Security model
The volume password is never passed as a command line argument. Command line arguments are visible to every process on the machine (ps aux), so this server always pipes the password to VeraCrypt via stdin using VeraCrypt's official --stdin option.
There are two password sources:
1. OS keyring (recommended)
Store the password once in the OS keyring. The MCP tool then only receives a keyring account name, so the password never enters the LLM context, chat logs, or transcripts.
macOS (Keychain):
security add-generic-password -s veracrypt-mcp -a my-container -w
# you will be prompted for the password interactively
Linux (libsecret / GNOME Keyring, requires libsecret-tools):
secret-tool store --label="veracrypt-mcp my-container" service veracrypt-mcp account my-container
Then mount with keychain_account: "my-container".
2. Direct password (fallback)
You can pass password directly to the tool. It is still piped via stdin to VeraCrypt (never visible in the process list), but it passes through the LLM conversation and may be stored in chat logs. Use the keyring source whenever possible.
3. Keyfiles and hardware tokens
keyfiles (or VERACRYPT_MCP_KEYFILES, comma separated) maps to VeraCrypt -k and works with an empty password. If a keyfile is missing, the tool answers Key nicht freigegeben instead of trying other credentials. With default keyfiles configured and a keychain account set, a missing keyfile falls back to the keychain password once (useful while a volume still has its old password); if VeraCrypt rejects it, the answer is again Key nicht freigegeben.
For keyfiles that only exist after the user unlocks a hardware token (YubiKey plus PIN), set VERACRYPT_MCP_UNLOCK_COMMAND. When no credential is passed, the tool runs that command with --interaktiv; the command asks the user, mounts the volume and exits non-zero if the key was not released. Nothing is cached, so every mount needs the user's input.
Additional notes:
- Passwords are never logged and never included in tool results or error messages.
- Python cannot securely wipe strings from memory; for maximum security, use the keyring source and a dedicated container password.
Requirements
- Python >= 3.10
- VeraCrypt with the command line binary available (
veracrypton PATH, the macOS app bundle, or setVERACRYPT_PATH) - macOS: macFUSE (required by VeraCrypt for mounting)
- Linux keyring source:
libsecret-tools(secret-tool)
Installation
pip install git+https://github.com/bitterdev/veracrypt-mcp.git
Or from a local clone:
git clone https://github.com/bitterdev/veracrypt-mcp.git
cd veracrypt-mcp
pip install .
Configuration
Claude Code
claude mcp add veracrypt -- veracrypt-mcp
With a default vault (recommended):
claude mcp add veracrypt \
-e VERACRYPT_MCP_CONTAINER="/path/to/vault.hc" \
-e VERACRYPT_MCP_KEYCHAIN_ACCOUNT="my-vault" \
-- veracrypt-mcp
Claude Desktop / generic MCP client
{
"mcpServers": {
"veracrypt": {
"command": "veracrypt-mcp",
"env": {
"VERACRYPT_MCP_CONTAINER": "/path/to/vault.hc",
"VERACRYPT_MCP_KEYCHAIN_ACCOUNT": "my-vault"
}
}
}
}
The server runs over stdio.
Usage examples
With a configured default vault:
Mount my vault
Unmount my vault
Explicit, without defaults:
Mount the container /Users/me/secret.hc using the keychain account "my-container"
Mount read-only at a specific mount point:
Mount /Users/me/secret.hc read-only at ~/mnt/secret, keychain account "my-container"
Environment variables
| Variable | Description |
|---|---|
VERACRYPT_MCP_CONTAINER |
Default container path used when no container_path is given |
VERACRYPT_MCP_KEYCHAIN_ACCOUNT |
Default keyring account used when no password source is given |
VERACRYPT_MCP_MOUNT_POINT |
Default mount directory (otherwise VeraCrypt auto-selects) |
VERACRYPT_MCP_KEYFILES |
Default keyfile paths, comma or newline separated |
VERACRYPT_MCP_UNLOCK_COMMAND |
Interactive unlock command, called with --interaktiv |
VERACRYPT_PATH |
Absolute path to the VeraCrypt binary if it is not on PATH |
Tests
python -m unittest discover -s tests
The tests create throwaway containers and need the VeraCrypt CLI.
License
MIT, see LICENSE.
Author
Fabian Bitter (fabian@bitter.de)
VeraCrypt MCP Fragen
Wie füge ich VeraCrypt MCP zu Claude Code hinzu?
Führe claude mcp add veracrypt-mcp -- uvx veracrypt-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich VeraCrypt MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie geht der Server sicher mit Passwörtern um?
Der Server leitet das Passwort über stdin an VeraCrypt weiter, indem er die offizielle --stdin Option nutzt. So wird sichergestellt, dass Passwörter niemals in der Prozessliste sichtbar sind.
Was ist der empfohlene Weg, Passwörter zu verwalten?
Es wird empfohlen, das Passwort im OS-Keyring (macOS Keychain oder Linux libsecret) zu speichern, damit das Passwort niemals in den LLM-Kontext gelangt.
Kann ich Hardware-Token wie YubiKey verwenden?
Ja, du kannst einen VERACRYPT_MCP_UNLOCK_COMMAND für Keyfiles festlegen, die eine Entsperrung per Hardware-Token erfordern.