mdadul/db-mcp

Self-hosted MCP gateway that gives AI coding agents read-only access to your databases.

About db-mcp

Give Claude Code, Cursor, Windsurf, or any MCP-compatible AI tool read-only access to your databases — without exposing credentials or risking data changes.

Self-hosted. Everything runs locally. Your passwords never leave your machine.

https://github.com/user-attachments/assets/f768ff6f-3c9e-4583-9179-c7022d3b7487

Database Notes --------- PostgreSQL All versions MySQL MySQL 5.7+ / MariaDB SQLite Local file, no server needed Amazon Redshift SSL required, Redshift-specific catalog queries

Instead of copy-pasting query results between your DB client and your AI tool, the gateway lets your AI query the database directly. It can explore schemas, inspect tables, and run SELECT queries. It cannot insert, update, delete, or drop anything.

Option A — Docker (recommended, no local install needed)

docker compose pulls the pre-built image from Docker Hub — no build step required. The MCPTOKEN is printed by setup.sh — copy it before you close the terminal.

Open http://localhost:4080. Your MCPTOKEN is in .env.

Claude.ai requires HTTPS. Expose the gateway through a tunnel first:

Copy the https://... URL from the tunnel output, then add it in Claude.ai → Settings → Integrations → Add MCP Server.

"How many orders were created this week?" "What columns does the users table have?" "Show me the last 10 failed jobs."

The AI will call the gateway tools automatically — no copy-pasting.

Tool What it does ------------------- listdatabases Lists all connected databases getdatabaseschema Lists tables (optional name filter) gettableschema Shows columns, indexes, and foreign keys for a tabl

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/mdadul--db-mcp.html)

Related MCP servers