EdgeDB MCP 서버 개요 및 사용 방법

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

- 대상자: 소프트웨어 개발자, DevOps 엔지니어

- 난이도: 중급 (CLI 도구 사용 및 프로젝트 통합 기술 필요)

핵심 요약

• EdgeDB MCP 서버는 EdgeDB 데이터베이스의 쿼리, 관리, 스키마 관리 기능을 제공하는 Model Context Protocol (MCP) 기반 도구입니다.
• 설치 및 실행: npm install -g @obiwan90/edgedb-mcp-server 명령어로 설치 가능하며, edgedb-mcp-server 명령어로 실행합니다.
• Cursor 통합: ~/.cursor/mcp.json 설정 파일에 edgedb-server 구성을 추가하여 Cursor 편집기와 연동 가능합니다.

섹션별 세부 요약

1. **Database Management Tools**

- 데이터베이스 연결 지원 (DSN 및 인스턴스 이름 기반)

- 기존 데이터베이스 목록 조회 및 새로운 데이터베이스 생성 가능

- 현재 데이터베이스 전환 및 정보 확인 기능 제공

2. **Query Tools**

- EdgeQL 쿼리 실행 기능 (파라미터 전달 가능)

- 단일/다중 레코드 검색 (필터링, 정렬, 페이징 지원)

- 쿼리 결과의 효율적인 처리와 반환

3. **Schema Management Tools**

- 데이터베이스 타입 목록 조회 (시스템 타입 포함 가능)

- 타입 상세 정보 확인 및 스키마 구조 비교 기능

- 스키마 설계 변경 시 즉시 반영 가능

4. **설치 및 실행 명령어**

- npm 설치: npm install -g @obiwan90/edgedb-mcp-server

- 로컬 프로젝트에 통합: npm install @obiwan90/edgedb-mcp-server

- CLI 실행: edgedb-mcp-server 명령어로 서버 실행

5. **프로젝트 구조**

- src/config/: 설정 관리

- src/resources/: MCP 리소스 정의

- src/tools/: MCP 툴 정의 (database.ts, query.ts, schema.ts 등)

- src/index.ts: 애플리케이션 진입점

6. **Cursor 통합 가이드**

- ~/.cursor/mcp.json 파일에 edgedb-server 설정 추가

- 예시: "edgedb-server":{"command":"npx","args":["-y","@obiwan90/edgedb-mcp-server@latest","--instanceName","your-instance-name"]}

- Cursor 재시작 후 명령 팔레트(Cmd+Shift+P) 또는 채팅 인터페이스를 통해 EdgeDB 툴 사용 가능

7. **라이선스**

- MIT License로 배포되어 자유롭게 사용 및 수정 가능

결론

• EdgeDB MCP 서버는 EdgeDB 데이터베이스 관리 및 개발 효율성을 높이는 DevOps 도구로, CLI 및 프로젝트 통합을 통해 활용 가능합니다. Cursor와의 통합은 개발자에게 직관적인 인터페이스를 제공하며, MIT 라이선스로 오픈소스로 제공되어 다양한 환경에서 사용 가능합니다.