de en es ja ko ru zh

db-legacy-migration-agent

Name: db-legacy-migration-agent
Author: felipeassis10

by felipeassis10

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

db-legacy-migration-companion

Inhaltsverzeichnis

Related MCP server: db-mcp

Überblick

Veraltete Unternehmenssysteme nutzen häufig herstellerspezifische SQL-Dialekte (Oracle PL/SQL, IBM DB2, Microsoft T-SQL), die ohne erheblichen manuellen Aufwand nicht direkt in moderne Software-Stacks migriert werden können. Dieses Tool automatisiert die strukturelle Übersetzung:

Eingabe	Ausgabe
`CREATE TABLE` (Oracle, DB2, MySQL, MSSQL)	Modelldefinitionen für `schema.prisma`
PL/SQL `CREATE PROCEDURE` / `CREATE FUNCTION`	Best-Effort-TypeScript-Äquivalent
Beliebige Mischung aus Legacy-DDL	TypeScript-Query-Helfer für den Prisma Client
Vollständige DDL-Datei	Validierungsbericht mit Präzisionsverlust-Analyse

Architektur

src/
├── parser/
│   └── sql-transpiler.ts     # DDL lexer/parser + Prisma/TS code generator
├── engine/
│   └── schema-validator.ts   # Precision-loss & semantic mismatch validator
├── mcp/
│   └── server.ts             # MCP server (stdio transport)
└── cli.ts                    # Commander.js interactive CLI
tests/
└── transpiler.test.ts        # Jest unit tests (40+ assertions)

Kernmodule

`src/transpiler/sql-transpiler.ts`

Verantwortlich für die vollständige Transpilierungspipeline:

Tokenization – entfernt Kommentare, normalisiert Leerraum, behandelt Bezeichner in Anführungszeichen.
DDL-Parsing – CREATE TABLE mit Spalten, Constraints, Fremdschlüsseln und Indizes.
PL/SQL-Parsing – CREATE [OR REPLACE] PROCEDURE/FUNCTION mit Parameterrichtungen.
Typzuordnung – 40+ Legacy-Typzuordnungen auf { prismaType, postgresType }.
Prisma-Schema-Generierung – @@map, @db.*-Annotationen, zusammengesetzte Primärschlüssel, FK-Beziehungen.
TypeScript-Query-Generierung – CRUD-Helfer mit PrismaClient.
PL/SQL-Strukturübersetzung – BEGIN/END, IF/THEN/ELSIF, FOR/WHILE LOOP, :=, DBMS_OUTPUT.

`src/engine/schema-validator.ts`

Führt eine Regel-Engine über die transpilierten Tabellendefinitionen aus und erzeugt strukturierte ValidationIssue-Datensätze:

Kritisch – Datenverlust garantiert (z. B. BIGINT_OVERFLOW, NULLABLE_PK).
Warnung – semantische Abweichung, die eine Überprüfung erfordert (z. B. ORACLE_DATE_HAS_TIME, XMLTYPE_NO_NATIVE).
Info – Informationen zur Nachvollziehbarkeit (z. B. LOB_TO_TEXT, DB2_GRAPHIC_TYPE).

`src/mcp/server.ts`

MCP-Server, der drei Tools über stdio-Transport anbietet:

Tool	Beschreibung
`parse_legacy_ddl`	Vollständiges Parsen + Generieren: gibt AST, Prisma-Schema und TS-Queries zurück
`generate_prisma_schema`	Gibt nur den Inhalt von `schema.prisma` zurück
`validate_type_mapping`	Gibt einen strukturierten oder als Text verfassten Validierungsbericht zurück

Erste Schritte

Voraussetzungen

Node.js ≥ 18
npm ≥ 9

Installation

npm install

Ausführen des Builds

npm run build

CLI global verfügbar machen (optional)

npm link
db-migrate --help

CLI-Befehle

`transpile <file>`

Analysiert eine DDL-Datei und erzeugt schema.prisma, queries.ts und ast.json im Ausgabeverzeichnis.

npx ts-node src/cli.ts transpile ./examples/oracle_hr.sql \
  --dialect oracle \
  --out ./output

Optionen:

Flag	Default	Beschreibung
`-d, --dialect`	`oracle`	Quelldialekt: `db2 \| oracle \| mysql \| mssql`
`-o, --out`	`./output`	Ausgabeverzeichnis
`--no-ts`	—	TypeScript-Query-Generierung überspringen
`--no-validate`	—	Validierung nach der Transpilierung überspringen

`validate <file>`

Validiert die Typzuordnungen und erstellt einen strukturierten Bericht.

npx ts-node src/cli.ts validate ./examples/oracle_hr.sql \
  --dialect oracle \
  --format text

Optionen:

Flag	Standard	Beschreibung
`-d, --dialect`	`oracle`	Quelldialekt
`-f, --format`	`text`	`text` oder `json`
`--fail-on-warnings`	—	Exit-Code 1, wenn Warnungen gefunden werden (für CI-Pipelines)

Exit-Codes:

Code	Bedeutung
`0`	Keine Probleme oder nur Informationen
`1`	Warnungen gefunden (nur mit `--fail-on-warnings`)
`2`	Kritische Probleme gefunden

`parse-inline <ddl>`

Schnelltest – eine DDL-Zeichenfolge direkt aus der Befehlszeile parsen.

npx ts-node src/cli.ts parse-inline \
  "CREATE TABLE T (ID NUMBER(10) NOT NULL, NAME VARCHAR2(100), CONSTRAINT PK_T PRIMARY KEY (ID));"

`mcp`

Startet den MCP-Server über stdio (für KI-Assistenten-Integration).

npx ts-node src/cli.ts mcp

MCP-Server

Der MCP-Server kann mit jedem MCP-kompatiblen KI-Assistenten (z. B. Claude Desktop, IBM watsonx Assistant) registriert werden.

Tool: Daemon

{
  "tool": "parse_legacy_ddl",
  "input": {
    "ddl": "CREATE TABLE EMPLOYEES (...);",
    "dialect": "oracle",
    "include_typescript": true
  }
}

Rückgabe: vollständiger AST, Prisma-Schema, TypeScript-Query, Warnungen.

Tool: `generate_prisma_schema`

{
  "tool": "generate_prisma_schema",
  "input": {
    "ddl": "CREATE TABLE EMPLOYEES (...);",
    "dialect": "oracle"
  }
}

Rückgabe: Inhalt von schema.prisma als einfacher String.

Tool: `validate_type_mapping`

{
  "tool": "validate_type_mapping",
  "input": {
    "ddl": "CREATE TABLE EMPLOYEES (...);",
    "dialect": "oracle",
    "format": "json"
  }
}

Rückgabe: strukturiertes ValidationReport-JSON oder Menschenlesbarer Text.

Typzuordnungsreferenz

Legacy-Typ	Prisma-Typ	PostgreSQL-Typ	Anmerkungen
`NUMBER(p)` / `NUMERIC`	`Decimal`	`DECIMAL(p)`	Genauigkeit bleiben erhalten
`NUMBER(p,s)`	`Decimal`	`DECIMAL(p,s)`	Skalierung bleibt erhalten
`NUMBER(p)` p≤9	`Int`	`INTEGER`	Passt in 32 Bit
`NUMBER(p)` 10≤p≤18	`BigInt`	`BIGINT`	Passt in 64 Bit
`NUMBER(p)` p>18	`Decimal`	`DECIMAL(p)`	⚠ BigInt würde überlaufen
`VARCHAR2(n)`	`String`	`VARCHAR(n)`
`CHAR(n)`	`String`	`CHAR(n)`	Array-Fester Länge (Padding)
`CLOB` / `NCLOB` / `LONG`	`String`	`TEXT`	ℹ Kein separates LOB-Segment
`BLOB` / `RAW`	`Bytes`	`BYTEA`	ℹ Inline-Speicherung
`DATE` (Oracle)	`DateTime`	`DATE`	⚠ Oracle DATE enthält Uhrzeit
`TIMESTAMP`	`DateTime`	`TIMESTAMP`
`TIMESTAMP WITH TIME ZONE`	`DateTime`	`TIMESTAMPTZ`
`BINARY_FLOAT`	`Float`	`REAL`	⚠ Einfache Präzision
`BINARY_DOUBLE`	`Float`	`DOUBLE PRECISION`
`XMLTYPE`	`String`	`XML`	⚠ Kein natives Prisma-XML
`BIGINT`	`BigInt`	`BIGINT`
`DECIMAL(p,s)`	`Decimal`	`DECIMAL(p,s)`
`BOOLEAN`	`Boolean`	`BOOLEAN`
`JSON` / `JSONB`	`Json`	`JSON` / `JSONB`

Validierungsregeln

Code	Schweregrad	Auslöser	Empfehlung
`ORACLE_NUMBER_NO_SCALE`	warning	`NUMBER(p)` ohne Skalierung; kann Ganzzahl oder Gleitkommazahl sein	Explizite Skalierung angeben
`BIGINT_OVERFLOW`	critical	`NUMBER(p)` bei p>18 auf BigInt abgebildet	`Decimal` / `NUMERIC` verwenden
`FLOAT_SINGLE_PRECISION`	warning	`BINARY_FLOAT` oder `FLOAT(≤24)` → REAL	`DOUBLE` verwenden
`LOB_TO_TEXT`	info	`CLOB`/`LONG` → TEXT	LOB-Streaming-APIs aktualisieren
`BLOB_TO_BYTEA`	info	`BLOB`/`RAW` → BYTEA	Für Werte > 1 GB die `lo`-API verwenden
`ORACLE_DATE_HAS_TIME`	warning	Oracle `DATE` → PostgreSQL `DATE`	`TIMESTAMP` verwenden, falls Uhrzeit benötigt wird
`LOCAL_TZ_SEMANTICS`	warning	`TIMESTAMP WITH LOCAL TIME ZONE`	Zeitzonen-Konvertierungslogik prüfen
`CHAR_LARGE_LENGTH`	warning	`CHAR(n)` n>255	Durch `VARCHAR(n)` ersetzen
`VARCHAR2_EXCEEDS_ORACLE_LIMIT`	info	`VARCHAR2(n)` n>4000	Für unbegrenzte Länge `TEXT` verwenden
`XMLTYPE_NO_NATIVE_XML`	warning	`XMLTYPE`	Für XML-Operationen `$queryRaw` verwenden
`DB2_GRAPHIC_TYPE`	info	DB2 `GRAPHIC`/`VARGRAPHIC`	UTF-8-/Unicode-Kodierung prüfen
`NO_PRIMARY_KEY`	warning	Tabelle hat keinen Primärschlüssel	`id` oder `@@id` hinzufügen
`NULLABLE_PK`	critical	Primärschlüsselspalte als nullable analysiert	Quell-DDL korrigieren

Projektstruktur

db-legacy-migration-agent/
├── src/
│   ├── parser/
│   │   └── sql-transpiler.ts    # Type mappings, DDL parser, Prisma & TS generators
│   ├── engine/
│   │   └── schema-validator.ts  # Rule engine, ValidationReport, formatter
│   ├── mcp/
│   │   └── server.ts            # MCP server with 3 tools
│   └── cli.ts                   # Commander.js CLI entrypoint
├── tests/
│   └── transpiler.test.ts       # Jest unit tests
├── dist/                        # Compiled output (after `npm run build`)
├── output/                      # Generated files (schema.prisma, queries.ts, ast.json)
├── package.json
├── tsconfig.json
└── README.md

Tests ausführen

# Run all tests
npm test

# With coverage
npm test -- --coverage

# Watch mode
npm test -- --watch

Erwartete Ausgabe: 40+ Aussagen zu Transpiler-Parsing, Typzuordnung, PL/SQL-Übersetzung und Validatorregeln.

Mitwirken

Repository öffnen und lokal klonen.
npm install ausführen, um Abhängigkeiten zu installieren.
Feature or Bugfix in src/ hinzufügen.
Tests in tests/ ergänzen oder aktualisieren.
Vor dem PR npm test und npm run typecheck ausführen.

Lizenz

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityStale

ResponsivenessNo issues

Resources

Related MCP Connectors

AI2SQLOAuth
io.ai2sql
Text-to-SQL MCP server: read-only queries on PostgreSQL, MySQL and SQL Server with your real schema
Databases Developer Tools
1
https://builder.ai2sql.io/api/chatgpt-mcp
SupabaseOAuth
com.supabase
MCP server for interacting with the Supabase platform
Cloud Platforms Databases Developer Tools
32,985
https://mcp.supabase.com/mcp
PostgreSQL MCP by InsightfulPipe AOAuth
com.insightfulpipe
Hosted PostgreSQL MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Databases Developer Tools
41
https://postgresql.insightfulmcp.com/
SQL Server MCP by InsightfulPipe AOAuth
com.insightfulpipe
Hosted SQL Server MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Databases Developer Tools
41
https://mssql.insightfulmcp.com/

Related MCP Servers

Database MCP Server
Databases Developer Tools Code Execution
roilanrodriguez55
A
license
Not graded
quality
C
maintenance
An extensible MCP server for database operations that supports PostgreSQL for managing schemas, tables, data, and user permissions. It features automatic migration recording for DDL changes and integrates with various AI-powered editors like Cursor, Zed, and Claude Code.
Updated 22 days ago (2026-10-09 02:57 UTC)
15 npm
2
MIT
db-mcp
Databases Developer Tools
zhusinian
A
license
A
quality
C
maintenance
A lightweight MCP server for relational databases, enabling dynamic connections to PostgreSQL and MySQL, SQL execution, and transaction control.
Updated 5 days ago (2026-10-26 06:30 UTC)
7
101 npm
1
MIT
CodeGuard
Code Analysis Developer Tools
Skhaaall
A
license
A
quality
D
maintenance
MCP server that analyzes TypeScript/Prisma projects, builds dependency graphs, and protects against dangerous modifications and silent regressions.
Updated 4 months ago (2026-06-20 01:43 UTC)
16
0
1
MIT
erdlens
Databases Developer Tools Software Architecture
ryanda9910
A
license
A
quality
C
maintenance
MCP server that reads your database schema from SQL DDL, Prisma, Drizzle, TypeORM, or SQLAlchemy, generates a Mermaid ER diagram, and writes it into your documentation, with drift detection to keep diagrams up-to-date.
Updated 4 months ago (2026-07-04 12:41 UTC)
5
1
MIT