SyncOFIMA

Replicación automática de tablas OFIMA (SQL Server) → Supabase (PostgreSQL)

• MCP Server para consultar los datos desde Claude.

Estructura

SyncOFIMA/
├── replicate.py      # Script de replicación
├── mcp_server.py     # MCP server para Claude
├── requirements.txt
├── .env.example      # Plantilla de variables de entorno
└── README.md

Related MCP server: Supabase MCP

Setup inicial

1. Instalar dependencias

pip install -r requirements.txt

En Windows necesitas tener instalado ODBC Driver 17 for SQL Server.
Descarga: https://learn.microsoft.com/en-us/sql/connect/odbc/download-odbc-driver-for-sql-server

2. Crear el archivo .env

cp .env.example .env

Llena las variables:

Replicación

Ejecutar manualmente

python replicate.py

Cómo funciona

• Lee cada tabla desde SQL Server (OFIMA)

• Borra y recrea la tabla en Supabase (sobrescritura total)

• Reintentos automáticos: máximo 3, con backoff exponencial (10s, 20s, 40s)

• Logs por stdout (visibles en Railway dashboard)

Configurar en Railway (Cron Job)

1. En tu proyecto Railway → New Service → Empty Service

2. En Settings → Source: apunta a este repositorio

3. En Settings → Start Command: python replicate.py

4. En Variables: agrega todas las del .env

5. En Cron Schedule: 0 2 * * * (todos los días a las 2:00 AM UTC)

⚠️ Ajusta la hora al timezone de tu servidor. Si OFIMA está en Colombia (UTC-5), usa 0 7 * * * para que corra a las 2:00 AM hora Colombia.

MCP Server (Claude.ai web)

Desplegar en Railway

1. En tu proyecto Railway → New Service → apunta al repositorio

2. Railway detecta el Procfile y corre python mcp_server.py automáticamente

3. Agrega la variable DATABASE_URL en las variables del servicio

4. Railway te da una URL pública tipo https://tu-app.up.railway.app

Conectar en Claude.ai web

1. En Claude.ai → icono de herramientas → Agregar conector personalizado

2. Nombre: OFIMA

3. URL del servidor MCP remoto: https://tu-app.up.railway.app/mcp

4. Guardar

Verás las herramientas disponibles:

Troubleshooting

Error: [ODBC Driver 17] Cannot open server

• Verifica que el host 172.200.231.95 sea accesible desde donde corres el script

• En Railway puede requerir que el servidor SQL Server tenga acceso desde IPs externas

Error: SSL connection required en Supabase

• Agrega ?sslmode=require al final del DATABASE_URL:
  postgresql://user:pass@host:5432/db?sslmode=require

Error: column X is of type Y but expression is of type Z

• Supabase es estricto con tipos. El script infiere tipos básicos pero puede fallar con tipos especiales de SQL Server.

• Solución: edita el pg_type_map en replicate.py para ajustar la columna problemática.

La tabla llega vacía

• Confirma que el usuario db_read tiene permisos de SELECT en esa tabla en OFIMA.

• Prueba la consulta directamente: SELECT TOP 10 * FROM dbo.nombre_tabla

MCP no aparece en Claude

• Verifica que la ruta en args sea la ruta absoluta correcta

• Corre python mcp_server.py manualmente para ver si hay errores

• Revisa los logs de Claude en %APPDATA%\Claude\logs\

Cambiar esquema de OFIMA

Si las tablas no están en dbo, agrega al .env:

OFIMA_SCHEMA=nombre_esquema