English Français العربية

io.github.arpe-io/migratorxpress-mcp

Registre officiel Données et bases de données

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.arpe-io/migratorxpress-mcp ?

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

Comment installer io.github.arpe-io/migratorxpress-mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.arpe-io/migratorxpress-mcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.arpe-io/migratorxpress-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.arpe-io/migratorxpress-mcp ?

Il est publié par arpe-io. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.