Gel

Servidor MCP Gel

Este servidor MCP fornece ferramentas e recursos que ajudam agentes de codificação a usar o banco de dados Gel.

Ferramentas disponíveis

1. execute_query: execute uma consulta contra a instância Gel configurada no projeto atual. Suporta argumentos e globais.
2. try_query: execute uma consulta em uma transação que é revertida no final, evitando modificação real de dados.
3. list_examples e fetch_example: acesse exemplos de código para fluxos de trabalho avançados, como configurar a extensão de IA.
4. list_rules e fetch_rule: caso você tenha esquecido de configurar as regras do Gel no seu editor de texto, o agente também pode acessá-las dessa forma.

Instalação

Se em algum momento você se perder, consulte este repositório para ver um exemplo de layout de configuração para o seu editor.

Cursor

1. Adicione o seguinte a .cursor/mcp.json:

{
  "mcpServers": {
    "gel": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

2. Abra as configurações do MCP, por exemplo, via Paleta de Comandos: View: Open MCP Settings e ative o Gel lá.

Claude Code

Adicione o seguinte a .mcp.json:

{
  "mcpServers": {
    "gel": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

VSCode com Copilot

Adicione o seguinte a .vscode/mcp.json:

{
  "servers": {
    "gel": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

Windsurf

Siga a documentação do Windsurf Cascade para abrir o mcp_config.json global por meio da interface clicável. Adicione o seguinte:

{
  "mcpServers": {
    "gel": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

Zed

Adicione o seguinte a .zed/settings.json:

{
  "context_servers": {
    "gel": {
      "source": "custom",
      "command": {
        "path": "uvx",
        "args": [
          "--refresh",
          "--python",
          "3.13",
          "--directory",
          ".",
          "--from",
          "git+https://github.com/geldata/gel-mcp.git",
          "gel-mcp"
        ],
        "env": {}
      }
    }
  }
}

Desenvolvimento

Clone o repositório e crie o ambiente virtual:

uv sync

Abra o servidor no MCP Inspector:

mcp dev src/gel_mcp/server.py