Gel Database MCP Server

What is Gel Database MCP Server?

A TypeScript-based Model Context Protocol (MCP) server for Gel database operations using EdgeQL queries. It provides tools for LLM agents (Cursor Agent, Claude Code, etc.) to automate learning about your schema, and writing, validating, and executing database queries.

How to use Gel Database MCP Server?

Install dependencies (yarn install), copy your dbschema folder, initialize a Gel project (npx gel project init), generate EdgeQL JavaScript query builder (npx @gel/generate edgeql-js), update connection settings in src/index_gel.ts, build the project (yarn build), and optionally include the gel_llm.txt documentation file. Then configure the server in your MCP client (e.g., Cursor) by adding a command server pointing to node build/index.js.

Key features of Gel Database MCP Server

• describe-schema: learn entity types, properties, relationships, and constraints.
• validate-query: validate raw EdgeQL syntax without executing.
• execute-edgeql: run raw EdgeQL queries and retrieve data.
• search-gel-docs: search Gel documentation for syntax, features, or examples.
• execute-typescript: run TypeScript Gel queries using the query builder syntax.

Use cases of Gel Database MCP Server

• An LLM agent learns your database structure before generating queries.
• Safely check EdgeQL query syntax without side effects during development.
• Autonomously execute EdgeQL queries based on natural language instructions.
• Search Gel documentation for relevant EdgeQL features or examples.
• Test and run programmatic TypeScript queries with the query builder.

FAQ from Gel Database MCP Server

What tools does Gel Database MCP Server provide?

It provides five tools: describe-schema, validate-query, execute-edgeql, search-gel-docs, and execute-typescript.

How do I set up Gel Database MCP Server in Cursor?

Add a new MCP server with type "Command" and enter node your/full/path/to/build/index.js. Then configure the connection settings in src/index_gel.ts before building.

Does Gel Database MCP Server work with agents other than Cursor?

The server is primarily tested with Cursor's agent, but it should work with other agents and LLMs that support the Model Context Protocol.

What is the hybrid documentation approach?

Both include the gel_llm.txt file in your project root (for direct file access) and use the search-gel-docs tool for targeted queries. This gives the LLM agent flexibility to search for specific terms or access the complete documentation when needed.

Are there any known limitations or risks?

Query generation is not included because LLMs can write more flexible queries. General JavaScript syntax errors in execute-typescript can crash the server, requiring a restart in the MCP client. This server is unofficial and older than Gel’s official MCP server.