겔 데이터베이스 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에서도 작동할 것입니다. 다른 에이전트로 테스트하시는 경우, 결과를 공유해 주세요!

사용 가능한 도구

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를 방문하세요.