# dbx

An MCP server that lets an AI agent run database queries through connections already configured in DBX.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 27669
- Author: t8y2
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/t8y2/dbx
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/dbx

## What it does

DBX is a database app with a desktop build, Docker, CLI and a built-in AI assistant. The MCP server hands that data access to your agent, so you can write queries in the Claude, Codex or Cursor chat instead of switching windows.

The server starts with `npx -y @dbx-app/mcp-server` over stdio. Connections come from your DBX setup, which means no connection strings or credentials get copied into the agent config. Set those connections up in DBX first — the server has nothing to expose without them.

DBX lists support for over 100 databases and ships in about 25 MB. Supported clients include Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline and Zed.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add dbx -- npx -y @dbx-app/mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add dbx -- npx -y @dbx-app/mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dbx": {
            "command": "npx",
            "args": [
                "-y",
                "@dbx-app/mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dbx": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@dbx-app/mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add dbx npx -y @dbx-app/mcp-server
```

## When to use it
- run a SQL query from the agent chat
- inspect table schemas without opening a separate client
- check live data against code while debugging
- pull a result set to test a hypothesis
- give an agent database access without copying connection strings

## Example prompts
- show me the schema of the users table
- run a query for the latest orders and show the result
- execute this query and explain what came back

## Similar
- [database-optimization](https://affpapa.org/en/nevibecode/agents/database-optimization.md) — subagent · 3924 installs
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 12927
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md