Gel Database MCP Server

@christian561

Repository

Basic information

About Gel Database MCP Server

MCP Server enabling LLM Agents to interact with Gel databases

#mathgpt #math-solver #math-assistant

Gel Database MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "gel-mcp-server": {
      "command": "npx",
      "args": [
        "gel",
        "project",
        "init"
      ]
    }
  }
}

Gel Database MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

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.

Frequently asked questions

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.

Comments

More Databases MCP servers

MCP Alchemy

runekaagaard

A MCP (model context protocol) server that gives the LLM access to and knowledge about relational databases like SQLite, Postgresql, MySQL & MariaDB, Oracle, and MS-SQL.

412