mcp-registry/db-mcp-server

    ==================
      
       /// MCP ///
      /// DB- ///
        
    ==================
        
    [server:online]
    [protocol:ready]

db-mcp-server

by FreePeak

Powerful multi-database Model Context Protocol (MCP) server that exposes structured tools (query, schema, performance, etc.) for MySQL, PostgreSQL and TimescaleDB.

255
24
Open Source
GitHubDocumentation

Installation

Prerequisites
1. Go ≥1.22 installed and added to your PATH (https://go.dev/dl/).
2. A running SQL database (PostgreSQL, MySQL, or SQLite).
3. (Optional) Docker if you prefer containerized deployment.
Quick Install (native)
# Fetch & compile the latest tagged binary go install github.com/FreePeak/db-mcp-server/cmd/db-mcp-server@latest # Verify installation $ db-mcp-server --version
Docker Install
docker pull freepeak/db-mcp-server:latest docker run -d --name mcp \ -p 8080:8080 \ -v $PWD/config.yaml:/app/config.yaml \ freepeak/db-mcp-server:latest
Configuration
1. Copy the example file `config.dist.yaml` to `config.yaml`.
2. Edit the `databases` section. Example for PostgreSQL:
databases: main: driver: postgres dsn: "postgres://user:password@localhost:5432/dbname?sslmode=disable"
3. (Optional) Set `auth.token` to any long random string to require Bearer tokens.
4. Start the server:
db-mcp-server --config ./config.yaml
Updating
# pull latest tag and rebuild go install github.com/FreePeak/db-mcp-server/cmd/db-mcp-server@latest

Documentation

License: MIT License
Updated 7/30/2025

Table of Contents