drawdb-mcp

Watch how to design database schemas using natural language with Claude AI.

The easiest way to get started is using Docker:

docker run \ --name drawdb-mcp \ -p 8080:80 \ -p 3000:3000 \ --restart unless-stopped \ ghcr.io/anatoly-lab/drawdb-mcp:latest

claude mcp add --transport http drawdb-mcp http://127.0.0.1:3000

Now Claude can create and modify database diagrams for you!

latesttracks stable releases only. Betas and release candidates are published under their exact version and never movelatest, so pin the full version to run one:

docker run \ --name drawdb-mcp \ -p 8080:80 \ -p 3000:3000 \ ghcr.io/anatoly-lab/drawdb-mcp:2.0.0-beta.1

- Node.js 20.19+ or 22.22+ (seeenginesinpackage.json)
- pnpm 8.15.0+ (install vianpm install -g pnpm)

git clone https://github.com/anatoly-lab/drawdb-mcp cd drawdb-mcp pnpm install pnpm dev

pnpm gui:dev # Access at http://localhost:5173

pnpm backend:dev # WebSocket at ws://localhost:3000/remote-control

pnpm build --filter=gui pnpm build --filter=backend

When running locally, connect Claude Code:

claude mcp add --transport http drawdb-mcp http://127.0.0.1:3000

The frontend connects to the backend over WebSocket automatically. Remember it is a view of the backend's state rather than the store: the tools keep working with no browser open, and a tab that reconnects adopts whatever the backend holds.

docker-compose up --build # Access at http://localhost:8080

docker build -t drawdb-mcp:local . docker run -p 8080:80 -p 3000:3000 drawdb-mcp:local

The Docker image includes both frontend and backend. WebSocket is proxied through Nginx.

When updating to a new version (whether via Docker or local development),you must perform a hard refresh in your browserto clear the cached frontend JavaScript:

- Windows/Linux:Ctrl + Shift + RorCtrl + F5
- macOS:Cmd + Shift + R

Without a hard refresh, the browser may continue using the old cached frontend code even though the backend has been updated, which can cause errors or unexpected behavior.

The MCP server provides tools for exporting and importing database diagrams in multiple formats:

- SQL DDL: Export database-specific SQL statements (PostgreSQL, MySQL, SQLite, MariaDB, MSSQL, Oracle)
- DBML: Export to Database Markup Language (human-readable, database-agnostic format)
- JSON: Export complete diagram state for backup/restore

- DBML: Import database schemas from DBML format
- JSON: Import complete diagram state

- export_sql- Export diagram as SQL DDL for current database type
- export_dbml- Export diagram as DBML
- import_dbml- Import database schema from DBML
- export_diagram- Export complete diagram as JSON
- import_diagram- Import complete diagram from JSON

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

connect a read-only replica, analytics database, or staging database. Keep credentials on your machine while the tool discovers schema, generates safe SQL, previews it for approval, runs the query, and summarizes the result.

An example of a remote, authentication-free MCP server deployable on Cloudflare Workers.

Efficient, SQL-backed C++ project indexer designed for large codebases with low memory footprint.

MCPg - Production-grade PostgreSQL MCP Server

Safe-by-default PostgreSQL Model Context Protocol server for AI agents.

Analyze, lint, and fix SQL queries using the SQLFluff linter.

MCP servers that give AI clients safe, structured access to SQL databases. One installable package per database engine. Every package exposes the same minimal two-tool surface, execute_sql and search_objects, with guardrails on by default: read-only mode, row caps, and statement timeouts.

Provides tools and resources for coding agents to interact with the Gel database, including automatic project configuration for query builders and ORMs.

MCP server that gives AI agents deep understanding of contemporary or legacy relational databases.

Browse, create, and manage schema projects on the Schematica schema library. 8 MCP tools for AI-powered schema design and data modeling.