English Français العربية

io.github.arpe-io/migratorxpress-mcp

Official registry Data and databases

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package migratorxpress-mcp
Claude Code 
claude mcp add migratorxpress-mcp -e 'MIGRATORXPRESS_PATH=<MIGRATORXPRESS_PATH>' -e 'MIGRATORXPRESS_TIMEOUT=<MIGRATORXPRESS_TIMEOUT>' -e 'MIGRATORXPRESS_LOG_DIR=<MIGRATORXPRESS_LOG_DIR>' -e 'LOG_LEVEL=<LOG_LEVEL>' -- uvx migratorxpress-mcp==0.1.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "migratorxpress-mcp": {
            "command": "uvx",
            "args": [
                "migratorxpress-mcp==0.1.6"
            ],
            "env": {
                "MIGRATORXPRESS_PATH": "<MIGRATORXPRESS_PATH>",
                "MIGRATORXPRESS_TIMEOUT": "<MIGRATORXPRESS_TIMEOUT>",
                "MIGRATORXPRESS_LOG_DIR": "<MIGRATORXPRESS_LOG_DIR>",
                "LOG_LEVEL": "<LOG_LEVEL>"
            }
        }
    }
}

Environment variables

  • MIGRATORXPRESS_PATH Path to the MigratorXpress binary (optional — server runs in preview-only mode without it)
  • MIGRATORXPRESS_TIMEOUT Execution timeout in seconds (default: 3600)
  • MIGRATORXPRESS_LOG_DIR Directory for execution logs (default: ./logs)
  • LOG_LEVEL Logging level: DEBUG, INFO, WARNING, ERROR (default: INFO)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MigratorXpress MCP Server
  2. Installation
  3. Configuration
  4. Tools
  5. Workflow Example
  6. Development
  7. License

MigratorXpress MCP Server

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

Frequently asked questions

What is io.github.arpe-io/migratorxpress-mcp?

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

How do I install io.github.arpe-io/migratorxpress-mcp?

It runs on your machine. In Claude Code: claude mcp add migratorxpress-mcp -e 'MIGRATORXPRESS_PATH=<MIGRATORXPRESS_PATH>' -e 'MIGRATORXPRESS_TIMEOUT=<MIGRATORXPRESS_TIMEOUT>' -e 'MIGRATORXPRESS_LOG_DIR=<MIGRATORXPRESS_LOG_DIR>' -e 'LOG_LEVEL=<LOG_LEVEL>' -- uvx migratorxpress-mcp==0.1.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.arpe-io/migratorxpress-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.arpe-io/migratorxpress-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.arpe-io/migratorxpress-mcp?

It is published by arpe-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.