Migratorxpress Mcp

io.github.arpe-ioPublished by GitHub account arpe-iov0.1.6Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyDatabasesDeveloper Tools

Overview

AI-generated overview

Local MCP server that lets an AI assistant preview, validate and execute MigratorXpress database migration commands between Oracle, PostgreSQL, SQL Server and N

What you can do
Preview and execute MigratorXpress migration commands, with a confirmation flag required before execution and license text masked in previews. Validate authentication files and check for specific auth_id entries. List supported source and target databases, tasks, migration DB modes, load and foreign-key modes. Suggest a full migration task sequence with example commands for a given source and target. Report the MigratorXpress version and capabilities.
When to use it
Useful when you are planning or running a cross-platform database migration with MigratorXpress and want an assistant to build commands, check auth files, and walk through the translate, create, transfer, diff and constraint-copy steps.
Requirements
Runs locally as a Python package over stdio; install with pip. Needs the MigratorXpress binary, located via MIGRATORXPRESS_PATH; without it the server runs in preview-only mode. Optional settings: MIGRATORXPRESS_TIMEOUT, MIGRATORXPRESS_LOG_DIR and LOG_LEVEL. A MigratorXpress authentication file with auth IDs is required for preview and execution.
Before you install
execute_command runs real migrations against source and target databases, so data can be written or changed; it requires confirmation set to true. The auth file holds database credentials and is passed as a parameter, and execution logs are written to MIGRATORXPRESS_LOG_DIR. Preview output masks license text, but review commands before confirming execution.

Installation

In SourceWeft

  1. Open Migratorxpress Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
pip install -e .

Or install dependencies directly:

bash
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:

bash
cp .env.example .env

Claude Code Configuration

Add to your Claude Code MCP settings:

json
{  "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 DDLStep 2: create     — Create target tables from translated DDLStep 3: transfer   — Transfer data from source to targetStep 4: diff       — Verify row counts match between source and targetStep 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

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

License

MIT

Source: README.md at commit c472372

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.6LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts