SQL-Transpiler MCP Tool

Transpile consultas SQL entre diferentes dialetos usando a biblioteca sqlglot.

Documentação

🚀 SQL-Transpiler MCP Tool

SQL-Transpiler é uma ferramenta MCP projetada para transpirar consultas SQL entre diferentes dialetos usando a biblioteca sqlglot. Esta ferramenta ajuda você a converter código SQL de um dialeto (ex.: MySQL) para outro (ex.: PostgreSQL) com facilidade, garantindo compatibilidade entre diversos sistemas de banco de dados.


🛠️ Recursos

  • Suporte a Dialetos: Lista todos os dialetos SQL suportados pelo sqlglot.
  • Transpilação SQL: Converte consultas SQL de um dialeto para outro.
  • Tratamento de Erros: Informa se um dialeto não é suportado ou se há erros de sintaxe.

📦 Biblioteca Utilizada

  • sqlglot
    Versão: Verifique seu pyproject.toml ou uv.lock para a versão exata utilizada neste projeto.

⚙️ Pré-requisitos

  • Python 3.13+ (se executado localmente)
  • UV gerenciador de pacotes (para gerenciamento de dependências)
  • Docker (se executado via contêiner)

🚀 Instalação

Opção 1: Usando UV (Localmente)

  1. Clone o repositório

    git clone https://github.com/Baronco/SQL-Transpiler-MCP-Tool.git
    cd sql-transpiler
    
  2. Instale o 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. Construa a imagem 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"]
    }
  }
}

Se você quiser usar seu ambiente local com UV em vez de Docker, configure seu claude_desktop_config.json da seguinte forma (ajuste o caminho conforme necessário):

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

📝 Licença

Licença MIT