migratorxpress-mcp

MigratorXpress MCP サーバー

Model Context Protocol（MCP）サーバーです。MigratorXpressを利用して、AI アシスタントを通じた異種データベースシステム間のデータベース移行を実現します。

MigratorXpress は、Oracle、PostgreSQL、SQL Server、Netezza から PostgreSQL または SQL Server への移行をサポートしています。

インストール

pip install -e .

または、依存関係を直接インストールします。

pip install -r requirements.txt

設定

環境変数

変数	デフォルト	説明
MIGRATORXPRESS_PATH	./MigratorXpress	MigratorXpress バイナリへのパス
MIGRATORXPRESS_TIMEOUT	3600	コマンド実行のタイムアウト（秒）
MIGRATORXPRESS_LOG_DIR	./logs	実行ログの保存ディレクトリ
LOG_LEVEL	INFO	サーバーのログレベル

.env.example を .env にコピーし、値を調整します。

cp .env.example .env

Claude Code の設定

Claude Code の MCP 設定に追加します。

{
  "mcpServers": {
    "migratorxpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/migratorxpress-mcp",
      "env": {
        "MIGRATORXPRESS_PATH": "/path/to/MigratorXpress"
      }
    }
  }
}

ツール

1. preview_command

MigratorXpress の CLI コマンドを組み立てて、実行せずにプレビューします。ライセンスのテキストは、表示される出力で自動的にマスキングされます。

必須パラメーター： auth_file、source_db_auth_id、source_db_name、target_db_auth_id、target_db_name、migration_db_auth_id

2. execute_command

プレビュー済みのコマンドを実行します。安全対策として confirmation: true が必要です。

3. validate_auth_file

認証ファイルが存在し、有効な JSON であることを検証します。また、必要に応じて特定の auth_id エントリーを確認します。

4. list_capabilities

サポートされている移行元／移行先データベース、タスク、移行データベースのモード、ロードモード、FK モードを一覧表示します。

5. suggest_workflow

移行元データベースの種類、移行先データベースの種類、および任意の制約フラグをもとに、移行タスクの全手順をサンプルコマンドとともに提案します。

6. get_version

MigratorXpress のバージョンと機能を報告します。

ワークフローの例

Oracle から PostgreSQL への一般的な移行：

Step 1: translate  — Translate Oracle DDL to PostgreSQL-compatible DDL
Step 2: create     — Create target tables from translated DDL
Step 3: transfer   — Transfer data from source to target
Step 4: diff       — Verify row counts match between source and target
Step 5: copy_pk    — Copy primary key constraints
        copy_ak    — Copy alternate key (unique) constraints
        copy_fk    — Copy foreign key constraints

または、--task_list all を指定して、すべての手順を 1 回の実行で行います。

開発

テストの実行

pip install -e ".[dev]"
python -m pytest tests/ -v

ライセンス

MIT