> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wimeisoftwares.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MigraFlow MCP Server para Cursor e Claude Desktop

> Configure o MigraFlow MCP Server para analisar schemas legados e gerar planos de migração direto no Cursor, Claude Desktop e IDEs com Model Context Protocol.

O MigraFlow MCP Server permite analisar schemas e gerar migration plans diretamente no **Cursor**, **Claude Desktop** ou qualquer IDE com suporte a MCP — sem sair do editor.

## Instalação

```bash theme={null}
pip install migraflow-mcp
```

<Note>
  Disponível apenas para clientes **Enterprise**. Solicite sua chave em [wimeisoftwares.com](https://wimeisoftwares.com).
</Note>

## Configuração no Cursor

Abra as configurações do Cursor e adicione ao `mcp.json`:

```json theme={null}
{
  "migraflow": {
    "command": "python",
    "args": ["-m", "mcp_server"],
    "env": {
      "MIGRAFLOW_API_KEY": "mk_consultant_xxx",
      "MIGRAFLOW_API_URL": "https://api.migraflow.com.br/api/v1"
    }
  }
}
```

## Configuração no Claude Desktop

Edite o arquivo de configuração do Claude Desktop:

**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "migraflow": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "env": {
        "MIGRAFLOW_API_KEY": "mk_consultant_xxx",
        "MIGRAFLOW_API_URL": "https://api.migraflow.com.br/api/v1"
      }
    }
  }
}
```

Reinicie o Claude Desktop após salvar.

## Ferramentas disponíveis

### analyze\_schema

Analisa um DDL legado e retorna mapeamento completo, risk score e scripts SQL.

```
analyze_schema(ddl, context, target_dialect)
```

| Parâmetro        | Tipo   | Descrição                                               |
| ---------------- | ------ | ------------------------------------------------------- |
| `ddl`            | string | DDL SQL com os CREATE TABLE do schema legado            |
| `context`        | string | Contexto de negócio (ex: `"ERP Oracle 11g financeiro"`) |
| `target_dialect` | string | Dialeto de destino: `postgresql`, `mysql`, `sqlserver`  |

**Exemplo de uso no Cursor:**

```
Analisa esse schema Oracle e gera o migration plan para PostgreSQL
```

### review\_migration

Revisa um script SQL gerado e retorna score de qualidade com issues e fixes.

```
review_migration(migration_sql, target_dialect, context)
```

| Parâmetro        | Tipo   | Descrição                 |
| ---------------- | ------ | ------------------------- |
| `migration_sql`  | string | Script SQL a ser revisado |
| `target_dialect` | string | Dialeto alvo              |
| `context`        | string | Contexto adicional        |

### validate\_schema

Valida a sintaxe do DDL e detecta o dialeto antes de enviar para análise completa.

```
validate_schema(ddl)
```

### get\_docs\_url

Retorna links para documentação e referência rápida.

## Exemplo de sessão no Cursor

```
Você: Analisa esse schema SQL Server 2012 e gera o migration plan

[cola o conteúdo do schema.sql]

MigraFlow: # MigraFlow Analysis Report

## Summary
- Tables mapped: 12
- Risk Score: 68/100 (Alto)
- Downtime estimate: 2-4h janela de manutenção

## Table Mapping
- `TB_CLI_REG` → `customers`
- `TB_PED` → `orders`
...

## CRITICAL Findings (1)
- **orders.dt_entrega**: Data armazenada como VARCHAR(8)
  > Fix: ALTER TABLE orders ADD COLUMN delivery_date DATE;

## Migration SQL
[script completo gerado]
```

## Suporte

Dúvidas sobre configuração: [wimeisoftwares.com](https://wimeisoftwares.com)