Skip to content

FreePeak/db-mcp-server

MCP Data & Storage

A multi‑database server that lets AI assistants query, transact, and analyze across MySQL, PostgreSQL, SQLite, Oracle, and TimescaleDB through a unified Model Context Protocol interface.

Go Latest v1.9.0 · 3mo ago Security brief →

Features

  • Simultaneous support for multiple database types (MySQL, PostgreSQL, SQLite, Oracle, TimescaleDB)
  • Lazy‑loading mode to defer connections until first use
  • Automatic generation of database‑specific tools (queries, transactions, schema analysis, performance insights)
  • Clean Architecture with clear separation of domain, repository, use case, and delivery layers
  • Full compatibility with OpenAI Agents SDK for seamless AI integration

Recent releases

View all 1 releases →
v1.9.0 New feature
Notable features
  • --unified-tools flag for consolidated tool registration
  • Shared tools with database parameter
Full changelog

New Features

  • Add --unified-tools flag for consolidated MCP tool registration (#55)

How it works

When connecting many databases (e.g. 30+), the server previously registered 5 tools per database — resulting in 150+ tools. With --unified-tools, only 6 shared tools are registered (query, execute, transaction, performance, schema, list_databases) that accept a database parameter.

Usage

# Default mode — per-database tools (no changes)
./db-mcp-server -c config.json

# Unified mode — shared tools with database parameter
./db-mcp-server -c config.json --unified-tools

Tool call in unified mode:

{
  "tool": "query",
  "parameters": {
    "database": "dev_accounting",
    "query": "SELECT * FROM users LIMIT 10"
  }
}

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
401
Forks
66
Languages
Go Shell Makefile

Install & Platforms

Install via
docker binary

Beta — feedback welcome: [email protected]