callakrsos/sql-gen-mcp repository overview

POST http://localhost:7070/mcp

StreamableHttpMcpTransport transport = StreamableHttpMcpTransport.builder()
        .url("http://localhost:7070/mcp")
        .logRequests(true)
        .logResponses(true)
        .build();

ai:
  mcp:
    servers:
      - name: "dbhelper"
        url: "http://localhost:7070/mcp"

GET  http://localhost:7070/sse          ← 연결
POST http://localhost:7070/messages     ← 메시지 전송 (?sessionId=xxx)

java -jar sql-gen-mcp-1.0.0-SNAPSHOT.jar --stdio

{
  "mcpServers": {
    "sql-gen-mcp": {
      "type": "stdio",
      "command": "java",
      "args": [
        "-jar",
        "C:/path/to/sql-gen-mcp-1.0.0-SNAPSHOT.jar",
        "--stdio"
      ]
    }
  }
}

server:
  port: 8081       # REST API (내부용)

mcp:
  port: 7070       # MCP 서버 포트 (외부 클라이언트 연결)

# VectorDB & RAG 임베딩 설정
ai:
  vector-store:
    provider: local   # local | ollama | vllm | gemini

    providers:
      ollama:
        base-url: "http://localhost:11434"
        model-name: "nomic-embed-text"
      vllm:
        base-url: "http://localhost:8000/v1"
        model-name: "your-vllm-model"
        api-key: "optional"
      gemini:
        api-key: "your-gemini-api-key"
        model-name: "text-embedding-004"

# 데이터베이스 연결
db:
  driver: org.postgresql.Driver
  url: jdbc:postgresql://localhost:5432/mydb
  user: myuser
  pw: mypassword
  schema-output-dir: docs/schema   # 스키마 JSON 저장 경로

# PostgreSQL
db:
  driver: org.postgresql.Driver
  url: jdbc:postgresql://localhost:5432/mydb

# MSSQL
db:
  driver: com.microsoft.sqlserver.jdbc.SQLServerDriver
  url: jdbc:sqlserver://localhost:1433;databaseName=mydb;encrypt=false

# Oracle
db:
  driver: oracle.jdbc.OracleDriver
  url: jdbc:oracle:thin:@localhost:1521:xe

DB 연결
  └─► POST /db/initializeSchema
        ├─ 테이블 스키마 추출
        ├─ docs/schema/tables/*.json 저장
        └─ 벡터 DB 인덱싱 (In-memory)
              └─► GET /knowledge/search?q=자연어 질문
                    └─ 하이브리드 검색 → 관련 테이블 정의서 반환

점수 체계 (같은 테이블에 여러 점수가 있으면 최대값 사용)
  ├─ 텍스트 키워드 매칭 (한국어·영어 모두 유효)
  │     ├─ 테이블명 정확 일치      : 1.00
  │     ├─ 테이블명 포함           : 0.90
  │     └─ 코멘트/컬럼명/remark 포함: 0.70
  ├─ 벡터 유사도 (영어 의미 커버)
  │     └─ cosine × 0.85 (영어 특화 모델 보정)
  └─ tool-metadata.json 가중치
        └─ score × boost (키워드 매칭 시에만 적용)

mvn clean package

java -jar target/sql-gen-mcp-1.0.0-SNAPSHOT.jar

chcp 65001 > nul
mvn package -DskipTests && java -Dfile.encoding=UTF-8 -Dstdout.encoding=UTF-8 -Dstderr.encoding=UTF-8 -jar target/sql-gen-mcp-1.0.0-SNAPSHOT.jar

java -jar target/sql-gen-mcp-1.0.0-SNAPSHOT.jar 8080

java -jar target/sql-gen-mcp-1.0.0-SNAPSHOT.jar --stdio

java -jar sql-gen-mcp-1.0.0-SNAPSHOT.jar --stdio \
  --db.driver=org.postgresql.Driver \
  --db.url=jdbc:postgresql://localhost:5433/mesdb \
  --db.user=tester1 \
  --db.pw=tester1

docker-compose up -d

# 빌드
docker build -t sql-gen-mcp .

# 실행 (환경변수로 DB 지정)
docker run -d \
  -p 7070:7070 \
  -p 8081:8081 \
  -e DB_DRIVER=org.postgresql.Driver \
  -e DB_URL=jdbc:postgresql://host.docker.internal:5432/mydb \
  -e DB_USER=myuser \
  -e DB_PW=mypassword \
  -v $(pwd)/docs/schema:/app/docs/schema \
  sql-gen-mcp

1. SchemaInitApplication 실행 → DB 스키마 추출 + docs/schema/*.json 저장
2. McpServer 실행 → HTTP/MCP 서버 시작 (포트 7070)

docker pull callakrsos/sql-gen-mcp:latest

docker run -d \
  -p 7070:7070 \
  -e DB_DRIVER=org.postgresql.Driver \
  -e DB_URL=jdbc:postgresql://host.docker.internal:5432/mydb \
  -e DB_USER=myuser \
  -e DB_PW=mypassword \
  callakrsos/sql-gen-mcp:latest

{
  "USERS": {
    "extraDescription": "사용자 로그인, 권한 관리에 사용",
    "boost": 1.5,
    "keywords": ["사용자", "로그인", "계정"]
  },
  "ORDER_HISTORY": {
    "extraDescription": "",
    "boost": 1.2,
    "keywords": ["주문", "배송"]
  }
}