겔 데이터베이스 MCP 서버

EdgeQL 쿼리를 사용하여 Gel 데이터베이스 작업을 간소화하도록 설계된 TypeScript 기반 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 프로젝트는 LLM 에이전트(Cursor Agent, Claude Code 등)를 위한 도구를 제공하여 스키마 학습, 데이터베이스 쿼리 작성, 검증 및 실행을 자동화합니다. 자연어를 통해 Gel 데이터베이스와 쉽게 상호 작용할 수 있습니다. Vibe 코더 여러분, 환호하세요!

참고: LLM은 더 유연한 쿼리를 작성할 수 있으므로 쿼리 생성은 포함되지 않습니다. Claude-3.7-sonnet-thinking을 사용하여 커서 에이전트로 테스트했으며, 관련 웹페이지를 연결하여 Gel 문서를 제공한 후 좋은 결과를 얻었습니다.

빠른 시작 가이드

지엑스피1

커서에서 MCP 서버 연결

1. 오른쪽 상단의 기어 아이콘 > MCP > +새 서버 추가를 클릭하세요.

2. 원하는 대로 이름을 지어주세요

3. 유형 선택: 명령

4. 다음을 입력하세요: node your/full/path/to/build/index.js

참고: 이 서버는 주로 Cursor 에이전트로 테스트되었지만, Model Context Protocol을 지원하는 다른 에이전트 및 LLM에서도 작동할 것입니다. 다른 에이전트로 테스트하시는 경우, 결과를 공유해 주세요!

Related MCP server: MCP Docs RAG Server

사용 가능한 도구

Gel Database MCP 서버는 다음과 같은 도구를 제공합니다.

설명 스키마

이를 통해 LLM 에이전트는 코드를 직접 검사하지 않고도 데이터베이스 구조를 파악하고 이해할 수 있습니다. 에이전트는 사용 가능한 엔터티 유형, 속성, 관계 및 제약 조건을 파악하여 더욱 정확한 쿼리를 생성할 수 있습니다.

사용 시기: 에이전트가 쿼리를 실행하기 전에 데이터베이스 엔터티의 구조를 이해해야 하는 경우입니다.

유효성 검사 쿼리

이를 통해 LLM 에이전트는 원시 EdgeQL 쿼리 구문을 실행하지 않고도 확인할 수 있으므로, 생성된 쿼리를 데이터베이스에 실행하기 전에 안전하게 검증할 수 있습니다.

사용 시기: 실행 부작용의 위험 없이 구문을 확인하기 위해 쿼리를 개발하는 동안.

실행-edgeql

이를 통해 LLM 에이전트는 원시 EdgeQL 쿼리를 실행하고, 데이터를 검색하고, 사용자의 지시에 따라 작업을 수행하여 데이터베이스와 직접 상호 작용할 수 있습니다. LLM은 EdgeQL 쿼리를 생성하고 이를 자율적으로 실행할 수 있습니다.

예:

검색-젤-문서

이 도구를 사용하면 LLM 에이전트가 Gel 문서를 검색하여 EdgeQL 구문, 기능 또는 예시에 대한 관련 정보를 찾을 수 있습니다. 에이전트가 Gel 데이터베이스 개념을 더 잘 이해할 수 있도록 맥락과 함께 포괄적인 결과를 제공합니다.

사용 시기: 에이전트가 특정 Gel/EdgeQL 기능에 대해 알아야 할 때, 구문을 이해해야 할 때, 데이터베이스 작업 구현에 대한 예를 찾아야 할 때.

예:

문서화 하이브리드 접근 방식에 대한 참고 사항: 최적의 결과를 얻으려면 다음 두 가지를 모두 권장합니다.

1. 프로젝트 루트에 gel_llm.txt 파일을 포함합니다(직접 파일 액세스를 위해)

2. 타겟 쿼리에 대한 search-gel-docs 도구 사용

이러한 하이브리드 접근 방식은 LLM 에이전트에게 특정 용어를 검색하는 동시에 필요한 경우 더 광범위한 맥락에서 전체 문서에 접근할 수 있는 유연성을 제공합니다.

실행-타입스크립트

execute-edgeql과 비슷하지만 쿼리 빌더 구문으로 만든 Typescript Gel 쿼리를 테스트하고 실행하는 데 사용할 수 있습니다.

도구에 지침이 포함되어 있지만, 상담원에게 어떤 지침이 있는지 물어보는 것이 좋습니다. 그래야 상황에 맞게 지침이 표시됩니다. 이렇게 하면 지침이 누락되는 것을 방지할 수 있습니다.

참고: 일반적인 JavaScript 구문 오류로 인해 서버가 중단될 수 있으므로 연결이 닫힌 것으로 나타나면 커서 MCP 설정에서 중단된 서버를 새로 고치거나 서버를 다시 시작해야 합니다.

LLM에 다음과 같은 모범 사례를 알려주세요.

• console.log와 함께 await gelClient.query() 사용하여 결과를 표시합니다.

• THEN과 함께 ORDER BY를 사용하고 쉼표는 사용하지 마세요(예: ORDER BY .field1 THEN .field2)

• 코드를 단순하게 유지하고 단일 작업에 집중하세요.

예:

사용 시기: 프로그래밍 논리가 필요한 복잡한 쿼리나 JavaScript로 쿼리 결과를 처리해야 하는 경우.

자세히 알아보기

모델 컨텍스트 프로토콜에 대한 자세한 내용은 modelcontextprotocol.io/quickstart를 방문하세요.