IA · Conector MCP

Que tu asistente de IA vea el esquema real, no que lo adivine.

huginndb-mcp es un servidor headless de Model Context Protocol que expone las conexiones que ya guardaste en HuginnDB — profiles.json, con contraseñas leídas del keychain del SO — a Claude Code, Claude Desktop, Cursor, Antigravity o Codex. Cualquier cliente MCP compatible con la especificación funciona igual en cuanto le indiques la ruta al binario.

Ajustes → MCP en la app resuelve la ruta del binario y genera cada snippet de abajo por ti — elige qué conexiones guardadas exponer, y pega.

Nivel de escritura, por conexión

read-only

Por defecto. Solo SELECT / find / describe — toda herramienta de escritura se rechaza.

data

Añade INSERT / UPDATE / DELETE a nivel de fila. Sin cambios de esquema.

full

Añade DDL — CREATE / DROP / ALTER / TRUNCATE.

Se relee de disco en cada intento de escritura — cambia el nivel de una conexión en la app y surte efecto sin reiniciar tu cliente de IA. Cada escritura queda registrada en mcp-audit.log, junto a tus perfiles.

Configurar un cliente

Sustituye la ruta por la que te muestre Ajustes → MCP.

Claude Code

bash

claude mcp add huginndb -s user -- /ruta/a/huginndb-mcp --connections <profile-id>

O escríbelo a mano en ~/.claude.json, o en un .mcp.json de proyecto:

json

{
  "mcpServers": {
    "huginndb": {
      "command": "/ruta/a/huginndb-mcp",
      "args": ["--connections", "<profile-id>"]
    }
  }
}

Claude Desktop

json

{
  "mcpServers": {
    "huginndb": {
      "command": "/ruta/a/huginndb-mcp",
      "args": ["--connections", "<profile-id>"]
    }
  }
}

Ajustes → Developer → Edit Config, y reinicia la app.

Cursor

json

{
  "mcpServers": {
    "huginndb": {
      "command": "/ruta/a/huginndb-mcp",
      "args": ["--connections", "<profile-id>"]
    }
  }
}

.cursor/mcp.json (de proyecto) o ~/.cursor/mcp.json (global) — o Ajustes → MCP → Add new global MCP server.

Antigravity

json

{
  "mcpServers": {
    "huginndb": {
      "command": "/ruta/a/huginndb-mcp",
      "args": ["--connections", "<profile-id>"]
    }
  }
}

Panel del Agente → menú «…» → MCP Servers → Manage MCP Servers → View raw config.

Codex CLI

toml

[mcp_servers.huginndb]
command = "/ruta/a/huginndb-mcp"
args = ["--connections", "<profile-id>"]

~/.codex/config.toml — o: codex mcp add huginndb -- /ruta/a/huginndb-mcp --connections <profile-id>

Herramientas expuestas

list_connections

Qué bases de datos alcanza el servidor, con el nivel de escritura efectivo.

list_tables / describe_table

Tablas, vistas, columnas, tipos, PK/FK, índices.

run_query

SQL o estilo mongosh, controlado por el nivel de escritura.

browse_table

Navega filas por página sin escribir una query.

insert_row / update_cell / delete_rows

Escrituras a nivel de fila, por PK. Requiere data o full.

server_version / list_users

Versión del motor, usuarios y privilegios del servidor.

Referencia completa en docs/MCP.md

Descargar Ver en GitHub