This Gel Database MCP Server provides a suite of tools to help LLM agents interact with a Gel database using the Model Context Protocol. It exposes capabilities to inspect your schema, validate and execute EdgeQL queries, and search Gel documentation to improve prompt accuracy. The main tools are describe-schema for learning the database structure, validate-query to check EdgeQL syntax without touching the database, execute-edgeql to run raw EdgeQL against your Gel instance, search-gel-docs to locate relevant Gel/EdgeQL information, and execute-typescript to run Gel queries written in TypeScript with the provided query builder. You typically run the server via Node and connect it from an MCP client like Cursor by adding a new Command-type server that points to node build/index.js. Once running, you can use describe-schema to map entities, then generate and validate EdgeQL with execute-edgeql, or test complex flows with execute-typescript. The search-gel-docs tool helps the agent learn from Gel documentation when needed, and you can pair it with the gel_llm.txt documentation file for richer context.

Prerequisites:

• Node.js and npm/yarn installed on your system
• Git (optional, for cloning the repository)
• Basic familiarity with MCP clients (e.g., Cursor)

Installation steps:

1. Clone the repository or download the source code git clone https://github.com/yourorg/christian561-gel-mcp-server.git cd christian561-gel-mcp-server

2. Install dependencies yarn install

   or using npm

   npm install

3. Prepare Gel project and schema (optional but recommended)

   • Copy your dbschema folder into the project if you have one
   • Run Gel project initialization and generate EdgeQL builders as described in the README

4. Build the project yarn build

5. Run the MCP server locally to verify node build/index.js

6. Connect from an MCP client (e.g., Cursor)

   • In Cursor MCP settings, add a new server of type Command with the value: node /path/to/your/project/build/index.js

Notes:

• If you encounter runtime errors, you can run the server with an inspector tool as described in the README to get better debugging output.

Tips and common considerations:

• The gel_llm.txt file should be placed in your project root to improve the agent's ability to access Gel documentation locally.
• The search-gel-docs tool complements direct file access by providing contextual results from Gel docs.
• When using execute-edgeql or execute-typescript, ensure your Gel database connection settings are correctly configured in the Gel project (src/index_gel.ts) as indicated in the README.
• General JavaScript/TypeScript tooling issues can crash the server; keep a restart workflow in place if the MCP connection is dropped.
• The recommended best practices for the execute-typescript tool include using gelClient.query() and structuring queries with explicit ordering (ORDER BY) and clear operations to minimize runtime surprises.