Vault — un pequeño servidor MCP personal

Notas + marcadores, almacenados en un único archivo SQLite, expuestos a Claude a través de 5 herramientas: add_note, add_bookmark, search_notes, list_notes, delete_note.

1. Instalar uv (una sola vez)

Abre PowerShell y ejecuta:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Cierra y vuelve a abrir la terminal después de esto para que uv esté en el PATH.

Related MCP server: MCP Notes Server

2. Configurar el proyecto

Descomprime esta carpeta en un lugar permanente, por ejemplo C:\Users\<tu>\mcp-vault. Luego, desde dentro de ella:

cd C:\Users\<you>\mcp-vault
uv sync

Esto crea un entorno virtual e instala fastmcp.

3. Probarlo de forma independiente (antes de tocar Claude Desktop)

uv run fastmcp dev server.py

Esto abre el Inspector MCP en tu navegador. Haz clic en la pestaña Tools, intenta llamar a add_note con algo de texto, luego list_notes — deberías verlo regresar. Ctrl+C para detenerlo cuando estés satisfecho.

4. Conéctalo a Claude Desktop

Abre (o crea) este archivo:

%APPDATA%\Claude\claude_desktop_config.json

Añade una entrada vault bajo mcpServers. Si el archivo ya tiene otros servidores, solo añade esta clave junto a ellos — no reemplaces todo el archivo.

{
  "mcpServers": {
    "vault": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\Users\\<you>\\mcp-vault",
        "fastmcp",
        "run",
        "server.py"
      ]
    }
  }
}

Reemplaza C:\\Users\\<tu>\\mcp-vault con la ubicación real de la carpeta — usa dobles barras invertidas como se muestra.

5. Reinicia Claude Desktop

Ciérralo completamente (clic derecho en el icono de la bandeja → Salir, no solo cerrar la ventana) y vuelve a abrirlo. Busca el icono de herramientas en el cuadro de chat — haz clic y deberías ver las 5 herramientas de vault listadas.

6. Pruébalo

• "Guarda una nota: renovar pasaporte, etiquétala como todo"

• "Guarda este enlace: https://example.com, titúlalo Ejemplo, etiquétalo como referencia"

• "¿Qué he guardado etiquetado como todo?"

• "Busca en mis notas pasaporte"

• "Elimina la nota 1"

Tus datos están en vault.db junto a server.py — es solo un archivo SQLite, así que puedes abrirlo con cualquier navegador SQLite si quieres inspeccionarlo directamente.

Capturas de pantalla

Notas

• El docstring de cada herramienta es lo que Claude lee para decidir cuándo llamarla — si renombras o reutilizas una herramienta, mantén el docstring preciso, esa es toda la interfaz.

• Si Claude Desktop no detecta el servidor, revisa %APPDATA%\Claude\logs\ para ver errores — generalmente es una ruta incorrecta en la configuración.