AI · MCP connector

Point your AI assistant at the real schema, not a guess.

huginndb-mcp is a headless Model Context Protocol server that exposes the connections you already saved in HuginnDB — profiles.json, passwords read from the OS keychain — to Claude Code, Claude Desktop, Cursor, Antigravity or Codex. Any spec-compliant MCP client works the same way once it's pointed at the binary.

Preferences → MCP in the app resolves the binary path and generates every snippet below for you — pick which saved connections to expose, then paste.

Write policy, set per connection

read-only

Default. Only SELECT / find / describe — every write tool is refused.

data

Adds row-level INSERT / UPDATE / DELETE. No schema changes.

full

Adds DDL — CREATE / DROP / ALTER / TRUNCATE.

Re-read from disk on every write attempt — change a connection's level in the app and it takes effect without restarting your AI client. Every write is recorded in mcp-audit.log next to your profiles.

Configuring a client

Replace the path with the one Preferences → MCP shows you.

Claude Code

bash

claude mcp add huginndb -s user -- /path/to/huginndb-mcp --connections <profile-id>

Or hand-write ~/.claude.json, or a project .mcp.json:

json

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

Claude Desktop

json

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

Settings → Developer → Edit Config, then restart the app.

Cursor

json

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

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global) — or Settings → MCP → Add new global MCP server.

Antigravity

json

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

Agent panel → “…” menu → MCP Servers → Manage MCP Servers → View raw config.

Codex CLI

toml

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

~/.codex/config.toml — or: codex mcp add huginndb -- /path/to/huginndb-mcp --connections <profile-id>

Tools exposed

list_connections

Which databases this server can reach, with effective write policy.

list_tables / describe_table

Tables, views, columns, types, PK/FK, indexes.

run_query

SQL or mongosh-style, gated by write policy.

browse_table

Page through rows without writing a query.

insert_row / update_cell / delete_rows

Row-level writes, PK-addressed. Requires data or full.

server_version / list_users

Engine version, server-side users and privileges.

Full reference in docs/MCP.md

Download for desktop View on GitHub