Vault Tools
Servidor MCP de conversão de arquivos com foco em privacidade: ferramentas para imagem, PDF e texto que rodam localmente na sua máquina
Documentação
Servidor MCP: Transformações Locais de Arquivos para Agentes de IA
59 ferramentas para converter, compactar, mesclar e transformar arquivos. Saídas previsíveis, E/S baseada em caminhos, zero chamadas de rede.
Privacidade por arquitetura
Nenhum byte de arquivo é enviado ao modelo. As ferramentas operam em caminhos e gravam saídas em disco. Algumas ferramentas retornam metadados extraídos (tags EXIF, somas de verificação, contagens de palavras) por design. Sem telemetria, sem chamadas de rede durante o processamento.
Além de ler/escrever
| Filesystem MCP | VaultTools MCP | |
|---|---|---|
| Ler e escrever arquivos | ✓ | ✓ |
| Conversão de formato (PNG → WebP, CSV → JSON…) | — | ✓ |
| Compactação e otimização | — | ✓ |
| Mesclar / dividir / organizar | — | ✓ |
| Metadados e somas de verificação | — | ✓ |
| Isolamento de diretório | — | ✓ |
| E/S baseada em caminhos (bytes de arquivo nunca no contexto) | — | ✓ |
O Filesystem MCP lê e escreve. O VaultTools transforma e mantém os bytes dos arquivos fora da conversa de IA.
Instalação
Configuração interativa que escolhe sua ferramenta de IA e diretório:
npx @vaulttools/mcp init
Ou execute diretamente:
npx @vaulttools/mcp --allowed-dir /path/to/your/files
Configuração
Adicione o VaultTools à configuração MCP da sua ferramenta de IA:
~/.claude.json
{
"mcpServers": {
"vaulttools": {
"command": "npx",
"args": [
"-y",
"@vaulttools/mcp",
"--allowed-dir",
"/path/to/your/files"
]
}
}
}
Ferramentas Disponíveis
59 ferramentas em 5 categorias: Imagem (14), PDF (11), Texto (17), Dev (12), Arquivo (5). Cada ferramenta lê arquivos de entrada, processa localmente e grava a saída. Os bytes dos arquivos permanecem no disco e nunca são enviados ao modelo.
Ver referência completa da ferramenta
Opções
| Flag | Descrição | Padrão |
|---|---|---|
--allowed-dir <path> | Diretório do qual o servidor pode ler (obrigatório, repetível) | nenhum |
--output-dir <path> | Diretório para arquivos de saída, padrão é allowed-dir | allowed-dir |
--verbose | Habilitar registro detalhado em stderr | desligado |
Aviso Legal
O servidor MCP VaultTools é projetado para que os bytes dos arquivos permaneçam na sua máquina e nunca sejam enviados ao modelo. Apenas caminhos de arquivos e metadados são trocados.
No entanto, o modelo de IA que chama essas ferramentas opera independentemente do VaultTools. O modelo pode optar por ler, registrar ou transmitir as saídas das ferramentas de acordo com seu próprio comportamento e as políticas de seu provedor. O VaultTools não tem controle sobre o que o modelo faz com os resultados depois que eles são retornados.
Ao usar o servidor MCP, você reconhece que o VaultTools não é responsável pela forma como o modelo de IA conectado lida com as respostas das ferramentas. Se você estiver processando arquivos sensíveis, revise as políticas de privacidade do seu provedor de IA.