{
  "markdown": "# MigratorXpress MCP Server\n\n<!-- mcp-name: io.github.arpe-io/migratorxpress-mcp -->\n\n[![PyPI](https://img.shields.io/pypi/v/migratorxpress-mcp)](https://pypi.org/project/migratorxpress-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/?q=arpe-io)\n\nA [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server for [MigratorXpress](https://aetperf.github.io/MigratorXpress-Documentation/), enabling database migration between heterogeneous database systems through AI assistants.\n\nMigratorXpress supports migrating from Oracle, PostgreSQL, SQL Server, and Netezza to PostgreSQL or SQL Server targets.\n\n## Installation\n\n```bash\npip install -e .\n```\n\nOr install dependencies directly:\n\n```bash\npip install -r requirements.txt\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `MIGRATORXPRESS_PATH` | `./MigratorXpress` | Path to MigratorXpress binary |\n| `MIGRATORXPRESS_TIMEOUT` | `3600` | Command execution timeout in seconds |\n| `MIGRATORXPRESS_LOG_DIR` | `./logs` | Directory for execution logs |\n| `LOG_LEVEL` | `INFO` | Server logging level |\n\nCopy `.env.example` to `.env` and adjust values:\n\n```bash\ncp .env.example .env\n```\n\n### Claude Code Configuration\n\nAdd to your Claude Code MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"migratorxpress\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"src.server\"],\n      \"cwd\": \"/path/to/migratorxpress-mcp\",\n      \"env\": {\n        \"MIGRATORXPRESS_PATH\": \"/path/to/MigratorXpress\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### 1. `preview_command`\n\nBuild and preview a MigratorXpress CLI command without executing it. License text is automatically masked in the display output.\n\n**Required parameters:** `auth_file`, `source_db_auth_id`, `source_db_name`, `target_db_auth_id`, `target_db_name`, `migration_db_auth_id`\n\n### 2. `execute_command`\n\nExecute a previously previewed command. Requires `confirmation: true` as a safety mechanism.\n\n### 3. `validate_auth_file`\n\nValidate that an authentication file exists, is valid JSON, and optionally check for specific `auth_id` entries.\n\n### 4. `list_capabilities`\n\nList supported source/target databases, tasks, migration DB modes, load modes, and FK modes.\n\n### 5. `suggest_workflow`\n\nGiven a source database type, target database type, and optional constraint flag, suggest the full sequence of migration tasks with example commands.\n\n### 6. `get_version`\n\nReport MigratorXpress version and capabilities.\n\n## Workflow Example\n\nA typical migration from Oracle to PostgreSQL:\n\n```\nStep 1: translate  — Translate Oracle DDL to PostgreSQL-compatible DDL\nStep 2: create     — Create target tables from translated DDL\nStep 3: transfer   — Transfer data from source to target\nStep 4: diff       — Verify row counts match between source and target\nStep 5: copy_pk    — Copy primary key constraints\n        copy_ak    — Copy alternate key (unique) constraints\n        copy_fk    — Copy foreign key constraints\n```\n\nOr run all steps in a single invocation with `--task_list all`.\n\n## Development\n\n### Running Tests\n\n```bash\npip install -e \".[dev]\"\npython -m pytest tests/ -v\n```\n\n## License\n\nMIT\n",
  "bytes": 3337,
  "sha": "86f871d4d27a560f7e9502563c53688bc0b44d5cc51d36d6d21b7c5a0249540f",
  "repo_slug": "arpe-io/migratorxpress-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_arpe_io_migratorxpress_mcp_6f5dbf9f/readme"
}