migratorxpress-mcp

MigratorXpress MCP 服务

一个用于 MigratorXpress 的 Model Context Protocol（MCP）服务，可通过 AI 助手在异构数据库系统之间迁移数据库。

MigratorXpress 支持从 Oracle、PostgreSQL、SQL Server 和 Netezza 迁移到 PostgreSQL 或 SQL Server 目标数据库。

安装

pip install -e .

或者直接安装依赖：

pip install -r requirements.txt

配置

环境变量

变量	默认值	描述
MIGRATORXPRESS_PATH	./MigratorXpress	MigratorXpress 二进制文件的路径
MIGRATORXPRESS_TIMEOUT	3600	命令执行超时时间，单位为秒
MIGRATORXPRESS_LOG_DIR	./logs	执行日志目录
LOG_LEVEL	INFO	服务日志级别

将 .env.example 复制为 .env 并调整相应值：

cp .env.example .env

Claude Code 配置

将以下内容添加到 Claude Code MCP 设置中：

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

工具

1. preview_command

构建并预览 MigratorXpress CLI 命令，但不执行该命令。显示输出中的许可证文本会自动隐藏。

必需参数： auth_file、source_db_auth_id、source_db_name、target_db_auth_id、target_db_name、migration_db_auth_id

2. execute_command

执行之前预览过的命令。需要设置 confirmation: true 作为安全措施。

3. validate_auth_file

验证身份验证文件是否存在、是否为有效的 JSON，并可选择检查其中是否包含指定的 auth_id 条目。

4. list_capabilities

列出支持的源数据库和目标数据库、任务、迁移数据库模式、加载模式及 FK 模式。

5. suggest_workflow

根据源数据库类型、目标数据库类型和可选的约束标志，建议完整的迁移任务顺序，并提供命令示例。

6. get_version

报告 MigratorXpress 版本和功能。

工作流示例

从 Oracle 迁移到 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

或者使用 --task_list all，在单次调用中运行所有步骤。

开发

运行测试

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

许可证

MIT