Back to Browse

Migratorxpress MCP Server

Developer ToolsModerate6.5MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for MigratorXpress — cross-platform database migration with parallel transfer

About

MCP server for MigratorXpress — cross-platform database migration with parallel transfer

Security Report

6.5
Moderate6.5Moderate Risk

Valid MCP server (3 strong, 1 medium validity signals). 4 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.

5 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

Path to the MigratorXpress binary (optional — server runs in preview-only mode without it)Optional

Environment variable: MIGRATORXPRESS_PATH

Execution timeout in seconds (default: 3600)Optional

Environment variable: MIGRATORXPRESS_TIMEOUT

Directory for execution logs (default: ./logs)Optional

Environment variable: MIGRATORXPRESS_LOG_DIR

Logging level: DEBUG, INFO, WARNING, ERROR (default: INFO)Optional

Environment variable: LOG_LEVEL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-arpe-io-migratorxpress-mcp": {
      "env": {
        "LOG_LEVEL": "your-log-level-here",
        "MIGRATORXPRESS_PATH": "your-migratorxpress-path-here",
        "MIGRATORXPRESS_LOG_DIR": "your-migratorxpress-log-dir-here",
        "MIGRATORXPRESS_TIMEOUT": "your-migratorxpress-timeout-here"
      },
      "args": [
        "migratorxpress-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

MigratorXpress MCP Server

PyPI License: MIT MCP Registry

A Model Context Protocol (MCP) server for MigratorXpress, enabling database migration between heterogeneous database systems through AI assistants.

MigratorXpress supports migrating from Oracle, PostgreSQL, SQL Server, and Netezza to PostgreSQL or SQL Server targets.

Installation

pip install -e .

Or install dependencies directly:

pip install -r requirements.txt

Configuration

Environment Variables

VariableDefaultDescription
MIGRATORXPRESS_PATH./MigratorXpressPath to MigratorXpress binary
MIGRATORXPRESS_TIMEOUT3600Command execution timeout in seconds
MIGRATORXPRESS_LOG_DIR./logsDirectory for execution logs
LOG_LEVELINFOServer logging level

Copy .env.example to .env and adjust values:

cp .env.example .env

Claude Code Configuration

Add to your Claude Code MCP settings:

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

Tools

1. preview_command

Build and preview a MigratorXpress CLI command without executing it. License text is automatically masked in the display output.

Required parameters: auth_file, source_db_auth_id, source_db_name, target_db_auth_id, target_db_name, migration_db_auth_id

2. execute_command

Execute a previously previewed command. Requires confirmation: true as a safety mechanism.

3. validate_auth_file

Validate that an authentication file exists, is valid JSON, and optionally check for specific auth_id entries.

4. list_capabilities

List supported source/target databases, tasks, migration DB modes, load modes, and FK modes.

5. suggest_workflow

Given a source database type, target database type, and optional constraint flag, suggest the full sequence of migration tasks with example commands.

6. get_version

Report MigratorXpress version and capabilities.

Workflow Example

A typical migration from Oracle to 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

Or run all steps in a single invocation with --task_list all.

Development

Running Tests

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

License

MIT

Reviews

No reviews yet

Be the first to review this server!