SQL-Transpiler MCP Tool

Transpila consultas SQL entre diferentes dialectos utilizando la librería sqlglot.

Documentación

🚀 Herramienta MCP SQL-Transpiler

SQL-Transpiler es una herramienta MCP diseñada para transpilar consultas SQL entre diferentes dialectos utilizando la biblioteca sqlglot. Esta herramienta te ayuda a convertir código SQL de un dialecto (por ejemplo, MySQL) a otro (por ejemplo, PostgreSQL) con facilidad, garantizando compatibilidad entre varios sistemas de bases de datos.


🛠️ Características

  • Soporte de dialectos: Lista todos los dialectos SQL compatibles con sqlglot.
  • Transpilación SQL: Convierte consultas SQL de un dialecto a otro.
  • Manejo de errores: Te informa si un dialecto no es compatible o si hay errores de sintaxis.

📦 Biblioteca utilizada

  • sqlglot
    Versión: Consulta tu pyproject.toml o uv.lock para la versión exacta utilizada en este proyecto.

⚙️ Requisitos previos

  • Python 3.13+ (si se ejecuta localmente)
  • UV administrador de paquetes (para la gestión de dependencias)
  • Docker (si se ejecuta mediante contenedor)

🚀 Instalación

Opción 1: Usando UV (localmente)

  1. Clona el repositorio

    git clone https://github.com/Baronco/SQL-Transpiler-MCP-Tool.git
    cd sql-transpiler
    
  2. Instala UV

    pip install uv
    
    
  3. Sync dependencies (using uv.lock)

    uv sync --frozen
    
    
  4. Run the server

    uv run server.py
    

Option 2: Using Docker

  1. Clone the repository

    git clone https://github.com/your-username/sql-transpiler.git
    cd sql-transpiler
    
  2. Construye la imagen de Docker

    docker build -t sql-transpiler .
    

📄 Usage

  • Use the Dialects tool to list all supported SQL dialects.
  • Use the Transpiler tool to convert SQL queries from one dialect to another.

For more details, see the instructions in src/instructions.md.

🖥️ Integration with Claude Desktop

To add the SQL-Transpiler MCP tool to your Claude Desktop configuration using the Docker image, update your claude_desktop_config.json as follows:

{
  "mcpServers": {
    "sql-transpiler": 
    {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--init", "-e", "DOCKER_CONTAINER=true", "sql-transpiler"]
    }
  }
}

Si deseas usar tu entorno local con UV en lugar de Docker, configura tu claude_desktop_config.json de la siguiente manera (ajusta la ruta según sea necesario):

{
  "mcpServers": {
    "sql-transpiler": 
    {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/sql-transpiler",
        "run",
        "server.py"
      ]
    }
  }
}

📝 Licencia

MIT License