local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides support for executing TypeScript Gel queries made with query builder syntax to interact with Gel databases.

Servidor MCP de base de datos de gel

Un servidor de Protocolo de Contexto de Modelo (MCP) basado en TypeScript, diseñado para optimizar las operaciones de la base de datos Gel con consultas EdgeQL. Este proyecto proporciona herramientas para agentes LLM (Cursor Agent, Claude Code, etc.) que automatizan el aprendizaje de su esquema, así como la escritura, validación y ejecución de consultas de base de datos. Interactúe fácilmente con su base de datos Gel mediante lenguaje natural. ¡Programadores de Vibe, descúbralo!

Nota: No se incluye la generación de consultas, ya que los LLM pueden escribir consultas más flexibles. Se probó esto con el agente Cursor usando Claude-3.7-sonnet-thinking y se obtuvieron buenos resultados tras proporcionar la documentación de Gel enlazando las páginas web relevantes.

Guía de inicio rápido

# 1. Install dependencies
yarn install

# 2. Copy your dbschema folder into the project if you have one already 
# cp -r /path/to/your/dbschema ./
# or just copy and paste

# 3. Initialize a Gel project
npx gel project init
# Follow prompts to set up a new project 
# Can point to an existing gel instance by providing the name of your instance
#   -Import migrations if it asks

# 4. Generate EdgeQL JavaScript query builder files
npx @gel/generate edgeql-js
# Note: Re-run this command after any schema changes

# 5. Update connection settings
# Edit src/index_gel.ts lines 19-25 with your database, host, port, user, password
# Edit src/index_gel.ts line 37 with your branch name

# 6. Build the project
yarn build

# 7. (optional) Test the server runs without errors
node build/index.js

# 7.1 (if you have errors) Test server with a UI that provides more clear error logs using: 
npx @modelcontextprotocol/inspector node build/index.js

# 8. (Recommended) Include the gel_llm.txt documentation file
# Download the Gel documentation file and place it in your project root
# This allows both the search tool and direct file access for your LLM agent
# curl -o gel_llm.txt https://raw.githubusercontent.com/yourorg/gel-docs/main/gel_llm.txt
# Note: Replace the URL with the actual source of your gel_llm.txt file

Conectar el servidor MCP en el cursor

Haga clic en el ícono de engranaje en la parte superior derecha > MCP > +Agregar un nuevo servidor
Ponle el nombre que quieras
Seleccionar tipo: Comando
Ingresa esto: nodo tu/ruta/completa/a/construir/index.js

Nota: Si bien este servidor se ha probado principalmente con el agente de Cursor, debería funcionar con otros agentes y LLM compatibles con el Protocolo de Contexto de Modelo. Si realiza pruebas con otros agentes, no dude en compartir sus resultados.

Herramientas disponibles

El servidor MCP de la base de datos Gel proporciona las siguientes herramientas:

esquema de descripción

Esto ayuda a su agente LLM a aprender y comprender la estructura de su base de datos sin tener que inspeccionar manualmente el código. El agente puede descubrir los tipos de entidad disponibles, sus propiedades, relaciones y restricciones para generar consultas más precisas.

Cuándo usarlo: cuando su agente necesita comprender la estructura de una entidad de base de datos antes de consultarla.

validar consulta

Esto ayuda a su agente LLM a verificar la sintaxis de consulta de EdgeQL sin ejecutarla, lo que permite una validación segura de las consultas generadas antes de que se ejecuten en su base de datos.

Cuándo usarlo: Durante el desarrollo de consultas para verificar la sintaxis sin correr el riesgo de efectos secundarios en la ejecución.

ejecutar-edgeql

Esto permite que su agente LLM interactúe directamente con su base de datos ejecutando consultas EdgeQL sin procesar, recuperando datos y realizando operaciones según sus instrucciones. Su LLM puede generar consultas EdgeQL y ejecutarlas de forma autónoma.

Ejemplo:

SELECT Product { name, price } FILTER .price > 100;

buscar-gel-docs

Esta herramienta permite a su agente LLM buscar en la documentación de Gel para encontrar información relevante sobre la sintaxis, las características o los ejemplos de EdgeQL. Ofrece resultados completos con contexto para que el agente comprenda mejor los conceptos de la base de datos de Gel.

Cuándo usarlo: cuando su agente necesita aprender sobre características específicas de Gel/EdgeQL, comprender la sintaxis o encontrar ejemplos para implementar operaciones de base de datos.

Ejemplo:

search_term: "for loop"
context_lines: 10  # Optional: Number of context lines to show (default: 5)
match_all_terms: true  # Optional: Require all terms to match (default: false)

Nota sobre el enfoque híbrido de documentación: para obtener resultados óptimos, recomendamos ambos:

Incluir el archivo gel_llm.txt en la raíz del proyecto (para acceso directo al archivo)
Uso de la herramienta search-gel-docs para consultas específicas

Este enfoque híbrido le brinda a su agente LLM la flexibilidad de buscar términos específicos y también acceder a la documentación completa cuando sea necesario para un contexto más amplio.

ejecutar-mecanografiado

Similar a execute-edgeql pero se puede usar para probar y ejecutar consultas Typescript Gel realizadas con la sintaxis del generador de consultas.

Las instrucciones están incluidas en la herramienta, pero es recomendable preguntar al agente qué instrucciones tiene para que las cargue en contexto. Esto garantiza que no las omita.

Nota: Los errores generales de sintaxis de JavaScript pueden hacer que el servidor se bloquee, por lo que si la conexión aparece como cerrada, tendrá que actualizar el servidor bloqueado en la configuración de Cursor MCP o reiniciar el servidor.

Dígale al LLM que estas son las mejores prácticas:

Utilice await gelClient.query() con console.log para mostrar los resultados
Utilice ORDER BY con THEN, no comas (por ejemplo, ORDER BY .campo1 THEN .campo2)
Mantenga el código simple y centrado en una sola operación

Ejemplo:

console.log(await gelClient.query(`
  SELECT Product { 
    name, 
    price 
  } 
  FILTER .price > 100 
  ORDER BY .price DESC 
  LIMIT 5;
`));

Cuándo usarlo: para consultas complejas que requieren lógica programática o cuando necesita procesar resultados de consultas con JavaScript.

Más información

Para obtener más información sobre el Protocolo de contexto de modelo, visita modelcontextprotocol.io/quickstart .

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor MCP basado en TypeScript que permite a los agentes LLM interactuar con bases de datos Gel a través del lenguaje natural, proporcionando herramientas para aprender esquemas de bases de datos, validar y ejecutar consultas EdgeQL.

Related Resources

Reddit Discussion about this server

Gel Database MCP Server

Integrations

Servidor MCP de base de datos de gel

Guía de inicio rápido

Conectar el servidor MCP en el cursor

Herramientas disponibles

esquema de descripción

validar consulta

ejecutar-edgeql

buscar-gel-docs

ejecutar-mecanografiado

Más información

Related Resources

Appeared in Searches