Gel

Servidor MCP de Gel

Este servidor MCP proporciona herramientas y recursos que ayudan a los agentes de codificación a usar la base de datos Gel.

Herramientas disponibles

1. execute_query: ejecuta una consulta contra la instancia de Gel configurada en el proyecto actual. Admite argumentos y globales.
2. try_query: ejecuta una consulta en una transacción que se revierte al final, evitando la modificación real de datos.
3. list_examples y fetch_example: accede a ejemplos de código para flujos de trabajo avanzados, como configurar la extensión de IA.
4. list_rules y fetch_rule: en caso de que olvides configurar las reglas de Gel en tu editor de texto, el agente también puede acceder a ellas de esta manera.

Instalación

Si en algún momento te pierdes, consulta este repositorio para ver un ejemplo de configuración para tu editor.

Cursor

1. Agrega lo siguiente 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. Abre la configuración de MCP, por ejemplo, a través de la Paleta de comandos: View: Open MCP Settings y activa Gel allí.

Claude Code

Agrega lo siguiente 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 con Copilot

Agrega lo siguiente 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

Sigue la documentación de Windsurf Cascade para abrir el mcp_config.json global a través de la interfaz clicable. Agrega lo siguiente:

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

Zed

Agrega lo siguiente 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": {}
      }
    }
  }
}

Desarrollo

Clona el repositorio y crea el entorno virtual:

uv sync

Abre el servidor en el MCP Inspector:

mcp dev src/gel_mcp/server.py