AI导哈

SQL存储过程迁移工具

MSSQL存储过程/函数分析及Java + Spring Boot + MyBatis迁移标准化/自动化工具，提供VS Code集成和RAG技术支持。

  • by 42-saoh
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 42-saoh/test_mcp_server_with_codex

使用说明

MSSQL Migration MCP Server (Python)

MSSQL Stored Procedure / Function을 분석하고, Java + Spring Boot + MyBatis 마이그레이션을 표준화/자동화하기 위한 MCP(Model Context Protocol) 서버입니다.
VS Code에서 GitHub Copilot과 연동하여 SP/FN 분석 결과, 변환 가이드, RAG 기반 참고 자료를 툴 형태로 제공하는 것을 목표로 합니다.

주요 기능

1) SP/FN 분석

  • SP/FN 에 사용하고 있는 함수 및 테이블 추출
  • 트랜잭션 패턴 분석 (BEGIN/COMMIT/ROLLBACK, TRY/CATCH)
  • 마이그레이션 영향 로직 탐지 (CURSOR, 동적 SQL, 임시테이블, MERGE 등)
  • 제어 흐름 분석 (IF/WHILE/CASE/RETURN)
  • 데이터 변경 유형 분류 (SELECT/INSERT/UPDATE/DELETE/MERGE)
  • 에러/예외 처리 패턴 분석

2) 공통 기능 후보 판별

  • 해당 SP/FN을 호출하는 다른 SP/FN 존재 여부 및 호출 수 확인
  • 재사용/확장 가능성(유틸화 가능성) 평가
  • 비즈니스 규칙 추출 및 표준 템플릿 매핑
  • 호출 그래프(Call Graph) 생성
  • 공통화 위험도 스코어링

3) 마이그레이션 설계 지원

  • Java/MyBatis 매핑 전략 추천
  • 트랜잭션 경계 제안
  • MyBatis 변환 난이도 평가

4) 품질/운영 지원

  • 성능 리스크 탐지
  • DB 의존도 점수

5) RAG 기반 표준화(옵션)

  • 사내 표준 문서/가이드, 변환 규칙, 예제 코드 등을 인덱싱
  • 분석 결과와 함께 근거 문서/권장 패턴을 함께 반환

MCP API

Endpoints

  • GET /health: 서버 상태 확인 ({"status":"ok"})
  • POST /mcp/analyze: SP/FN 분석 결과 반환
  • POST /mcp/standardize/spec: 표준화 스펙 생성 (5.1)
  • POST /mcp/standardize/spec-with-evidence: 표준화 스펙 + 근거 문서 (5.2)
  • POST /mcp/callers: 호출 관계(콜러) 분석
  • POST /mcp/external-deps: 외부 의존성 분석
  • POST /mcp/common/reusability: 유틸화 가능성 평가(스코어/사유/권장사항)
  • POST /mcp/common/rules-template: 비즈니스 규칙 + 템플릿 매핑
  • POST /mcp/common/call-graph: 호출 그래프 생성
  • POST /mcp/migration/mapping-strategy: Java + MyBatis 매핑 전략 추천
  • POST /mcp/migration/mybatis-difficulty: MyBatis 변환 난이도 평가
  • POST /mcp/migration/transaction-boundary: 트랜잭션 경계 가이드
  • POST /mcp/quality/performance-risk: 성능 리스크 분석
  • POST /mcp/quality/db-dependency: DB 의존도 분석

Notes

  • Offline only (no network, no DB, no API keys required for tests).
  • No raw SQL is returned in API responses.
  • Deterministic outputs for identical inputs (ordering and truncation are stable).

Example curl

curl -X POST http://localhost:9700/mcp/analyze \
  -H "Content-Type: application/json" \
  -d '{"sql":"<SQL_PLACEHOLDER>","dialect":"tsql"}'

curl -X POST http://localhost:9700/mcp/standardize/spec-with-evidence \
  -H "Content-Type: application/json" \
  -d '{"object":{"name":"dbo.usp_Name","type":"procedure"},"sql":"<SQL_PLACEHOLDER>","options":{"docs_dir":"data/standard_docs","top_k":3}}'

curl -X POST http://localhost:9700/mcp/migration/mapping-strategy \
  -H "Content-Type: application/json" \
  -d '{"name":"dbo.usp_Name","type":"procedure","sql":"<SQL_PLACEHOLDER>","options":{"target_style":"rewrite"}}'

VS Code MCP (HTTP)

VS Code 설정 예시 (.vscode/mcp.json)

{
  "servers": {
    "mssql-migration": {
      "type": "http",
      "url": "http://localhost:9700/mcp"
    }
  }
}

실행 방법

uvicorn app.main:app --host 0.0.0.0 --port 9700

Handshake expectations

  1. initialize (JSON-RPC request)
  2. notifications/initialized (JSON-RPC notification)
  3. tools/list
  4. tools/call

MCP tools

tsql.analyze

  • 설명: T-SQL을 분석하여 참조/트랜잭션/제어 흐름/마이그레이션 영향 등을 반환한다.
  • Input schema 요약:
    • sql (string, required): 분석 대상 T-SQL
    • dialect (string, optional, default: tsql)
  • Output 요약:
    • references, transactions, migration_impacts, control_flow, data_changes, error_handling, errors

相关 MCP