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.

Diagrama de arquitectura del proyecto

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

Captura de pantalla de la configuración del cursor MCP

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. imagen

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. imagen

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;

imagen

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.

imagen

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

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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

Related MCP Servers

MemGPT MCP Server
Vic563
-
security
F
license
-
quality
A TypeScript-based server that provides a memory system for Large Language Models (LLMs), allowing users to interact with multiple LLM providers while maintaining conversation history and offering tools for managing providers and model configurations.
Last updated -
20
JavaScript
my-server MCP Server
vivalalova
-
security
F
license
-
quality
A TypeScript-based MCP server that enables users to manage text notes and generate summaries, showcasing key MCP concepts like resource representation and LLM integration.
Last updated -
1,667
JavaScript
MCP LLMS-TXT Documentation Server
langchain-ai
-
security
A
license
-
quality
An MCP server that provides tools to load and fetch documentation from any llms.txt source, giving users full control over context retrieval for LLMs in IDE agents and applications.
Last updated -
177
Python
MIT License
MCP Docs RAG Server
kazuph
-
security
F
license
-
quality
A TypeScript MCP server that allows querying documents using LLMs with context from locally stored repositories and text files through a RAG (Retrieval-Augmented Generation) system.
Last updated -
1
JavaScript

View all related MCP servers

Gel Database MCP Server