devvault-mcp

Un pequeño servidor MCP que le da a Claude Code acceso estructurado a la base de datos Postgres local de DevVault: inspeccionar el esquema, ejecutar consultas de solo lectura, realizar escrituras protegidas y sembrar datos ficticios para pruebas.

Conexión

DATABASE_URL se resuelve en este orden:

1. process.env.DATABASE_URL

2. DEVVAULT_ENV_PATH (ruta a un archivo .env), si está configurado

3. ../devvault-backend/.env

Así, la contraseña de la base de datos permanece en el .env del backend y no se duplica en ninguna configuración de MCP.

Related MCP server: PostgreSQL MCP Server

Herramientas

Protecciones de seguridad

• run_query rechaza cualquier cosa que no sea de solo lectura y bloquea la acumulación de declaraciones (;).

• run_write rechaza DROP/TRUNCATE/ALTER/CREATE/GRANT/… y rechaza UPDATE/DELETE sin cláusula WHERE, a menos que pases allowDangerous: true.

• Las escrituras se ejecutan dentro de una transacción y se revierten en caso de error.

Registro con Claude Code

Ya configurado mediante ../.mcp.json (ámbito del proyecto):

{
  "mcpServers": {
    "devvault-db": {
      "command": "node",
      "args": ["/Users/cookie/project-git/devvault_2/devvault-mcp/server.js"]
    }
  }
}

Los servidores MCP se cargan al inicio de Claude Code, así que reinicia o vuelve a conectar la sesión para que aparezcan las herramientas de devvault-db.

Comprobaciones locales (no se necesita cliente MCP)

npm install
node smoke.js     # connectivity + row counts
node mcptest.js   # full MCP handshake: list tools + call a few

Datos ficticios

Las filas sembradas creadas por seed_dummy tienen títulos que comienzan con Dummy . Para eliminarlas:

DELETE FROM prompts  WHERE title LIKE 'Dummy %';
DELETE FROM commands WHERE title LIKE 'Dummy %';
DELETE FROM snippets WHERE title LIKE 'Dummy %';
DELETE FROM bookmarks WHERE title LIKE 'Dummy %';
DELETE FROM notes    WHERE title LIKE 'Dummy %';