freepeak/db-mcp-server

모델 컨텍스트 프로토콜(MCP)을 구현한 강력한 다중 데이터베이스 서버로, AI 보조원에게 데이터베이스에 구조화된 접근을 제공합니다.

개요 • 핵심 개념 • 특징 • 지원 데이터베이스 • 배치 옵션 • 구성 • 사용 가능한 도구 • 예시 • 문제 해결 • 기여

📄 제품 요구사항 — 현재 역량, 로드맵 및 결정

개요

DB MCP 서버는 AI 모델이 여러 데이터베이스와 동시에 상호작용할 수 있는 표준화된 방식을 제공합니다. FreePeak/cortex 프레임워크 위에 구축되어 AI 어시스턴트가 SQL 쿼리를 실행하고, 트랜잭션을 관리하며, 스키마를 탐색하고, 통합 인터페이스를 통해 다양한 데이터베이스 시스템 간 성능을 분석할 수 있게 합니다.

핵심 개념

다중 데이터베이스 지원

전통적인 데이터베이스 커넥터와 달리, DB MCP 서버는 여러 데이터베이스에 동시에 연결되고 상호작용할 수 있습니다:

동적 도구 생성

연결된 각 데이터베이스마다 서버는 자동으로 특수 도구를 생성합니다:

클린 아키텍처

서버는 다음 계층에 대해 클린 아키텍처 원칙을 따릅니다:

1. 도메인 계층: 핵심 비즈니스 엔터티 및 인터페이스

Overview

The DB MCP Server provides a standardized way for AI models to interact with multiple databases simultaneously. Built on the FreePeak/cortex framework, it enables AI assistants to execute SQL queries, manage transactions, explore schemas, and analyze performance across different database systems through a unified interface.

Core Concepts

Multi-Database Support

Unlike traditional database connectors, DB MCP Server can connect to and interact with multiple databases concurrently:

{
  "connections": [
    {
      "id": "mysql1",
      "type": "mysql",
      "host": "localhost",
      "port": 3306,
      "name": "db1",
      "user": "user1",
      "password": "password1"
    },
    {
      "id": "postgres1",
      "type": "postgres",
      "host": "localhost",
      "port": 5432,
      "name": "db2",
      "user": "user2",
      "password": "password2"
    },
    {
      "id": "oracle1",
      "type": "oracle",
      "host": "localhost",
      "port": 1521,
      "service_name": "XEPDB1",
      "user": "user3",
      "password": "password3"
    }
  ]
}

Dynamic Tool Generation

For each connected database, the server automatically generates specialized tools:

// For a database with ID "mysql1", these tools are generated:
query_mysql1       // Execute SQL queries
execute_mysql1     // Run data modification statements
transaction_mysql1 // Manage transactions
schema_mysql1      // Explore database schema