Gel Database MCP Server

Name: Gel Database MCP Server
Author: christian561

@christian561

リポジトリ

Gel Database MCP Server について

MCP Server enabling LLM Agents to interact with Gel databases

#mathgpt #math-solver #math-assistant

基本情報

カテゴリ

データベース

ランタイム

node

トランスポート

stdio

公開者

christian561

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.