이 생성 된 전에 젤은 훨씬 쉽게 설정할 수있는 공식 MCP 서버. MCP 서버의 예였습니다. 공식 페이지: https://github.com/geldata/gel-mcp

TypeScript 기반 Model Context Protocol (MCP) 서버는 EdgeQL 쿼리를 사용하여 Gel 데이터베이스 작업을 간소화하도록 설계되었습니다. 이 프로젝트는 LLM Agents (Cursor Agent, Claude Code, etc)에 대한 학습을 자동화하여 스키마 및 쓰기, 검증 및 데이터베이스 쿼리를 실행합니다. 쉽게 자연 언어를 통해 젤 데이터베이스와 상호 작용합니다. Vibe 코퍼 rejoice!

참고: Query 생성은 LLMs가 더 유연한 쿼리를 쓸 수 있기 때문에 포함되지 않습니다. Claude-3.7-sonnet-thinking을 사용하여 Cursor 에이전트와 테스트를 거쳐 관련 웹 페이지를 링크하여 Gel docs를 제공한 후 좋은 결과를 얻었습니다.

빠른 시작 가이드

커서에 MCP 서버를 연결

1. 상단의 기어 아이콘을 클릭 > MCP > 새 서버 추가
2. 당신이 원하는 것을 이름
3. 유형 선택: 명령
4. 입력: 노드/전체/path/to/build/index.js

Gel Database MCP Server [Unofficial/Old]

This was created before Gel had an official MCP server which is a lot easier to setup. Leaving this one up though since it was an example of an MCP server I made. Official one here: https://github.com/geldata/gel-mcp

A TypeScript-based Model Context Protocol (MCP) server designed to streamline Gel database operations with EdgeQL queries. This project provides Tools for LLM Agents (Cursor Agent, Claude Code, etc) to automate learning about your schema, and writing, validating, and executing database queries. Easily interact with your Gel database through natural language. Vibe coders rejoice!

Note: Query generation is not included since LLMs can write more flexible queries. Tested this with Cursor agent using Claude-3.7-sonnet-thinking and had good results after providing Gel docs by linking the relevant webpages.

Quick Start Guide

# 1. Install dependencies
yarn install

# 2. Copy your dbschema folder into the project if you have one already 
# cp -r /path/to/your/dbschema ./
# or just copy and paste

# 3. Initialize a Gel project
npx gel project init
# Follow prompts to set up a new project 
# Can point to an existing gel instance by providing the name of your instance
#   -Import migrations if it asks

# 4. Generate EdgeQL JavaScript query builder files
npx @gel/generate edgeql-js
# Note: Re-run this command after any schema changes

# 5. Update connection settings
# Edit src/index_gel.ts lines 19-25 with your database, host, port, user, password
# Edit src/index_gel.ts line 37 with your branch name

# 6. Build the project
yarn build

# 7. (optional) Test the server runs without errors
node build/index.js

# 7.1 (if you have errors) Test server with a UI that provides more clear error logs using: 
npx @modelcontextprotocol/inspector node build/index.js

# 8. (Recommended) Include the gel_llm.txt documentation file
# Download the Gel documentation file and place it in your project root
# This allows both the search tool and direct file access for your LLM agent
# curl -o gel_llm.txt https://raw.githubusercontent.com/yourorg/gel-docs/main/gel_llm.txt
# Note: Replace the URL with the actual source of your gel_llm.txt file

Connect MCP Server in Cursor

1. Click on the gear icon on the top right > MCP > +Add a new server
2. Name it whatever you want
3. Select type: Command
4. Enter this: node your/full/path/to/build/index.js

Note: While this server has been primarily tested with Cursor’s agent, it should work with other agents and LLMs that support the Model Context Protocol. If you test with other agents, please feel free to contribute your findings!

Available Tools

The Gel Database MCP Server provides the following tools:

describe-schema