drio
Open app

Gel Database MCP Server

Source

MCP Server enabling LLM Agents to interact with Gel databases

Catalog onlyCatalog onlySTDIO

Overview

The Gel Database MCP Server is a TypeScript-based Model Context Protocol (MCP) server that enables LLM Agents to interact with Gel databases using EdgeQL queries, streamlining database operations and allowing natural language interactions.

To use the Gel Database MCP Server, follow these steps:

  1. Install dependencies using yarn install.
  2. Copy your dbschema folder into the project.
  3. Initialize a Gel project with npx gel project init.
  4. Generate EdgeQL JavaScript query builder files.
  5. Update connection settings in the src/index_gel.ts file.
  6. Build the project with yarn build.
  7. Optionally, test the server runs without errors.
  8. Include the gel_llm.txt documentation file for better LLM agent performance.
  • Tools for LLM Agents to automate learning about database schema. - Query validation to ensure safe execution of EdgeQL queries. - Direct execution of EdgeQL queries for data retrieval and operations. - Search functionality through Gel documentation for better understanding of EdgeQL syntax and features.
  1. Automating database queries through natural language.
  2. Validating EdgeQL queries before execution to prevent errors.
  3. Learning and understanding database structures for more accurate querying.
  4. Searching documentation for specific EdgeQL features or examples.

Add to your AI client

Use these steps to connect Gel Database MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "gel-mcp-server-christian561": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gel-mcp-server-christian561"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "gel-mcp-server-christian561": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gel-mcp-server-christian561"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "gel-mcp-server-christian561": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gel-mcp-server-christian561"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "gel-mcp-server-christian561": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gel-mcp-server-christian561"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gel-mcp-server-christian561": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gel-mcp-server-christian561"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "gel-mcp-server-christian561": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gel-mcp-server-christian561"
      ]
    }
  }
}

FAQ

Can the Gel Database MCP Server work with any LLM?

Yes! It is designed to work with any LLM that supports the Model Context Protocol.

Is there a specific database structure required?

No, but having a well-defined schema will help the LLM agent understand the database better.

How do I troubleshoot errors?

Use the inspector tool provided in the project to get clearer error logs.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1853,"uuid":"9120bc7b-7e90-42e4-ab4d-5d4fdd1ed1bf","name":"gel-mcp-server","title":"Gel Database MCP Server","description":"MCP Server enabling LLM Agents to interact with Gel databases","avatar_url":"https://avatars.githubusercontent.com/u/32586305?v=4","created_at":"$D2025-03-05T05:41:40.327Z","updated_at":"$D2025-03-12T10:21:19.096Z","status":"created","author_name":"christian561","author_avatar_url":"https://avatars.githubusercontent.com/u/32586305?v=4","tags":"mathgpt,math-solver,math-assistant","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/christian561/gel-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/christian561/gel-mcp-server/raw/main/header.jpg","type":null,"metadata":"{\"star\":\"1\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-02 19:58:38\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Research and data
Gel Database MCP Server — MCP Registry