Skip to main content
Glama
yslee1126

MCP Spring DB Tools

by yslee1126
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

MCP Spring DB Tools

Spring Boot 프로젝트의 데이터베이스 스키마 조회 및 쿼리 실행계획 분석을 위한 MCP(Model Context Protocol) 서버입니다.

이 MCP 서버는 stdio 방식만 지원합니다.

🎯 주요 기능

1. 데이터베이스 스키마 조회 (get_schema_info)

  • 테이블, 컬럼, 인덱스, Foreign Key 정보 조회

  • 컬럼 타입, NULL 허용 여부, 기본값, 코멘트 확인

2. 쿼리 실행계획 분석 (get_execution_plan)

  • SQL 쿼리의 실행계획 분석

  • 인덱스 사용 여부 및 성능 최적화 참고

  • SELECT, INSERT, UPDATE, DELETE 쿼리 지원

  • 성능 최적화 가이드 제공 (스캔 방식, 인덱스, 조인, 쿼리 구문 개선 제안)

3. 저장 프로시저 및 뷰 조회 (get_procedures, get_views)

  • 저장 프로시저(Stored Procedure) 목록 및 정의(SQL) 조회

  • 뷰(View) 목록 및 정의(SQL) 조회

  • 각 객체별 코멘트 및 상세 정보 확인

4. 데이터소스 목록 조회 (list_datasources)

  • 설정된 모든 데이터소스 목록 확인

  • 데이터베이스 타입, 호스트, 포트 정보 확인

Related MCP server: Postgres MCP Pro

📋 지원 데이터베이스

  • ✅ MySQL / MariaDB (MySQL 8.0.16+ 권장: 실행 계획 트리 형식 지원)

  • ✅ PostgreSQL

  • ✅ MSSQL

  • ✅ SQLite

사용 방법

IDE의 MCP 설정 파일에 다음과 같이 추가하여 사용합니다. uvx를 사용하므로 별도의 설치 과정이 필요 없으며, 실행 시점에 필요한 패키지를 자동으로 로드합니다.

IDE MCP 설정

설정 예시 (JSON):

{
  "mcpServers": {
    "spring-db-tools": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/yslee1126/spring-mcp-db-tools.git",
        "mcp-spring-db-tools",
        "/path/to/your-spring-project/src/main/resources/application.yml",
        "your-jasypt-secret-key",
        "PBEWithMD5AndDES",
        "your-fixed-salt",
        "1000"
      ],
      "env": {
        "DB_PASSWORD": "your_db_password",
        "DB_USERNAME": "your_db_username"
      }
    }
  }
}

💡 uvx --from git+<GitHub URL> 형태로 GitHub 저장소를 직접 참조합니다. PyPI 미등록되었습니다.

인자 설명:

순서

값

필수 여부

설명

1

--from

필수

uvx GitHub 직접 실행 옵션

2

git+https://github.com/yslee1126/spring-mcp-db-tools.git

필수

GitHub 저장소 주소

3

mcp-spring-db-tools

필수

실행할 패키지(스크립트) 이름

4

/path/to/application.yml

필수

application.yml 또는 .properties 파일의 절대 경로

5

your-jasypt-secret-key

선택

Jasypt 암호화 키 (기본값: "")

6

PBEWithMD5AndDES

선택

Jasypt 알고리즘 (기본값: PBEWithMD5AndDES)

7

your-fixed-salt

선택

Jasypt Fixed Salt (StringFixedSaltGenerator 사용 시)

8

1000

선택

Jasypt Iterations (기본값: 1000)

환경 변수 (env):

application.yml에서 ${변수명} 형태로 참조하는 환경 변수가 있다면, env 섹션에 해당 변수명과 값을 그대로 정의하면 됩니다. 변수명은 프로젝트마다 다를 수 있으므로 application.yml에서 사용하는 이름을 그대로 사용하세요.

# application.yml 예시
spring:
  datasource:
    username: ${DB_USERNAME}
    password: ${DB_PASSWORD}
    url: ${DATABASE_URL:jdbc:mysql://localhost:3306/mydb}
// mcp 설정의 env 예시
"env": {
  "DB_USERNAME": "myuser",
  "DB_PASSWORD": "mypassword",
  "DATABASE_URL": "jdbc:mysql://prod-host:3306/mydb"
}

IDE 재시작

설정 후 IDE를 재시작하거나 MCP 서버 목록을 새로 고침하여 활성화합니다.

📁 파싱 가능한 applicaion.yml, application.properties 파일 형식

1. 단일 데이터소스

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: admin
    password: secret
    driver-class-name: com.mysql.cj.jdbc.Driver

2. 다중 데이터소스

spring:
  datasource:
    primary:
      url: jdbc:mysql://localhost:3306/main_db
      username: admin
      password: admin123
    secondary:
      url: jdbc:postgresql://localhost:5432/logs_db
      username: postgres
      password: postgres

또는:

datasources:
  orders:
    url: jdbc:mysql://localhost:3306/orders
    username: user
    password: pass
  inventory:
    url: jdbc:mysql://localhost:3306/inventory
    username: user
    password: pass

3. 유연한 데이터소스 구조 (Custom Datasource Structure)

Spring 설정 하위의 임의의 키에 datasource가 포함된 경우도 인식합니다.

spring:
  primary-db:
    datasource:
      url: jdbc:sqlserver://...
      username: ...
  secondary-db:
    datasource:
      url: jdbc:sqlserver://...
      username: ...

4. Properties 파일 지원 (application.properties)

.yml 파일 뿐만 아니라 .properties 파일도 지원합니다.

표준 Spring Boot 스타일:

spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=admin
spring.datasource.password=secret
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

Legacy / Flat 스타일 (Prefix 없이):

jdbcUrl=jdbc:sqlserver://localhost:1433;databaseName=my_database
driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver
username=ENC(dummy-encrypted-username)
password=ENC(dummy-encrypted-password)

유연한 키 이름 지원:

  • jdbcUrl, jdbc-url, url 모두 인식

  • driverClassName, driver-class-name, driver-class 모두 인식

  • username, user 모두 인식

  • camelCase 및 kebab-case 혼용 지원

5. 환경변수 지원

spring:
  datasource:
    url: ${DATABASE_URL:jdbc:mysql://localhost:3306/mydb}
    username: ${DB_USER:admin}
    password: ${DB_PASSWORD}

6. SQLite 인 경우 yaml 설정

파일 기반 SQLite:

spring:
  datasource:
    url: jdbc:sqlite:./data/myapp.db
    driver-class-name: org.sqlite.JDBC

또는 절대 경로:

spring:
  datasource:
    url: jdbc:sqlite:/Users/username/projects/myapp/data/app.db
    driver-class-name: org.sqlite.JDBC

🔐 Jasypt 암호화 지원

application.yml에서 ENC() 형식으로 암호화된 값을 자동으로 복호화합니다.

spring:
  datasource:
    username: ENC(X8eU2hK9mLpF3...)
    password: ENC(Y7dT1gJ8nKoE4...)

설정 방법은 상단의 IDE MCP 설정 섹션을 참고하세요.

지원되는 알고리즘

  • PBEWithMD5AndDES (기본값)

  • PBEWithMD5AndTripleDES

  • PBEWITHHMACSHA512ANDAES_256

참고: Fixed Salt는 salt 문자열의 첫 8바이트만 사용됩니다.

🛠️ 로컬 개발 및 테스트

로컬 개발 환경 설정, 테스트 실행 방법, 그리고 개발 중인 내용을 직접 MCP로 연결하는 방법은 다음 문서를 참고하세요.

로컬 개발 가이드

📝 라이선스

MIT License

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yslee1126/spring-mcp-db-tools'

If you have feedback or need assistance with the MCP directory API, please join our Discord server