Neo4j의 Cypher MCP 서버 시작하기

Jason Koo 구독자 286명

요약

이 영상은 Neo4j의 Cypher MCP 서버를 활용해 AI 에이전트가 그래프 데이터베이스를 자연어로 제어하도록 설정하는 방법을 안내합니다. Cypher 쿼리 언어나 그래프 데이터 모델링 지식 없이도 AI가 자동으로 스키마를 조회하고 데이터를 읽고 쓰며 관리합니다. Astra UV 또는 Docker 환경에서 서버를 실행하고 VSCode Copilot을 통해 로컬과 원격 데이터베이스를 네임스페이스별로 연결해 크로스-DB 워크플로우를 실습합니다.

주요 키워드

Neo4j Cypher MCP Server MCP (Model Context Protocol) get-neo4j-schema read-neo4j-cypher write-neo4j-cypher Astra UV Docker VSCode Copilot Namespace 그래프 데이터 모델

하이라이트

🔑 MCP 서버를 통해 Cypher 쿼리 언어나 그래프 모델링 지식 없이도 AI 에이전트가 Neo4j 데이터베이스를 제어할 수 있습니다.
⚡️ get-neo4j-schema, read-neo4j-cypher, write-neo4j-cypher 세 가지 도구로 스키마 조회와 데이터 읽기·쓰기 과정을 자동화합니다.
🚀 Astra UV(가상 환경)와 Docker 컨테이너 두 가지 옵션으로 유연한 서버 배포 환경을 제공합니다.
📌 VSCode Copilot 확장에 MCP.json 설정만 추가하면 채팅창에서 자연어로 데이터베이스 명령을 실행할 수 있습니다.
🔄 네임스페이스별 서버 인스턴스를 사용해 로컬과 원격(영화) 데이터베이스를 동시에 관리합니다.
🔧 ‘JSON’ 노드를 자연어 프롬프트로 간단히 추가하고, 즉시 데이터베이스에서 생성 여부를 확인할 수 있습니다.
🌐 서로 다른 데이터베이스 간 ‘wedding gift’ 영화 데이터를 로컬 DB로 이동해 크로스-DB 활용을 실습합니다.

용어 설명

MCP 서버 (Model Context Protocol)

AI 에이전트가 외부 시스템과 상호작용하도록 표준화된 인터페이스를 제공하는 서버 프로토콜입니다.

Cypher

Neo4j 그래프 데이터베이스 전용 쿼리 언어로, 노드·관계 탐색과 조작에 특화되어 있습니다.

get-neo4j-schema

데이터베이스에 존재하는 노드 유형, 관계 유형, 속성 정보 등 그래프 스키마를 조회하는 도구입니다.

read-neo4j-cypher

자연어 요청을 Cypher 쿼리로 변환해 Neo4j에서 데이터를 읽어오는 도구입니다.

write-neo4j-cypher

자연어 요청을 Cypher 쿼리로 변환해 Neo4j에 데이터를 작성하거나 수정하는 도구입니다.

Astra UV

가상 환경 및 의존성 관리를 지원하는 Python 패키지로, 서버 실행용 환경을 손쉽게 구성합니다.

Docker

애플리케이션을 컨테이너 형태로 배포해 일관된 실행 환경을 제공하는 플랫폼입니다.

VSCode Copilot

GitHub Copilot 기반 자연어 코드 보조 확장으로 MCP.json 설정 후 채팅창에서 명령을 입력할 수 있습니다.

Namespace

서버 인스턴스를 구분하는 고유 식별자(네임스페이스)로, 복수 데이터베이스를 동시에 연결할 때 사용합니다.

Schema

그래프 데이터베이스에서 노드, 관계, 속성 구조를 정의하는 데이터 모델입니다.

MCP 서버(Model Context Protocol)가 무엇인지 설명하고, Cypher MCP 서버를 통해 AI 에이전트가 그래프 DB를 자연어로 제어하는 장점을 안내합니다. 별도 Cypher 쿼리 언어나 그래프 모델 지식 없이도 자동으로 쿼리가 생성됩니다.

[00:00] Neo4j의 Cypher MCP 서버를 소개합니다. MCP는 AI 에이전트가 외부 시스템과 쉽게 연동할 수 있게 해주는 모델 컨텍스트 프로토콜입니다.

[00:30] 이 서버의 주요 장점은 Cypher 언어나 그래프 데이터 모델을 몰라도 되며, AI 에이전트가 자연어를 Cypher로 변환해준다는 것입니다.

get-neo4j-schema로 스키마를 조회하고, read-neo4j-cypher로 데이터를 읽으며, write-neo4j-cypher로 데이터를 쓰는 세 가지 주요 도구를 소개합니다. 각 도구가 하는 역할과 처리 흐름을 설명합니다.

[00:56] 서버는 세 가지 도구를 제공합니다: get neo4j schema(스키마 조회), read Neo4j cipher(데이터 읽기), write Neo4j cipher(데이터 쓰기)입니다.

서버 실행 환경으로 Astra UV(가상 환경) 또는 Docker 컨테이너 두 가지 방법을 제시합니다. 각 옵션의 설치 요구 사항과 실행 명령을 비교해 유연한 배포 전략을 제공합니다.

[01:27] 서버는 astral uv나 Docker 두 플랫폼에서 실행 가능하며, 각각에 맞는 환경이 설치되어 있어야 합니다.

Visual Studio Code에서 새 폴더를 만들고 MCP.json 파일을 생성하는 과정을 안내합니다. 예제 설정을 복사해 ’servers’ 키 아래에 붙여넣고 자격 증명을 추가합니다.

[01:56] VS Code with Copilot에서 설정하는 방법을 시연합니다. MCP.json 파일을 생성하고 GitHub 저장소의 예시 설정을 복사해서 사용합니다.

[02:33] 올바른 자격 증명을 추가한 후 서버를 시작하고 채팅 창에서 데이터베이스와 상호작용을 시작할 수 있습니다.

서버를 시작한 뒤 VSCode 내 채팅창에서 자연어 프롬프트로 ‘JSON’ 노드를 추가합니다. 생성된 노드를 데이터베이스에서 즉시 확인하며 기본 CRUD 동작을 실습합니다.

[02:59] 간단한 테스트로 JSON 노드를 추가해보고 실제로 데이터베이스에 생성되었는지 확인합니다.

네임스페이스를 활용해 로컬 외에 원격 영화 데이터베이스를 추가 서버 인스턴스로 연결합니다. README에서 제공하는 읽기 전용 자격 증명을 적용합니다.

[03:09] 네임스페이스 기능을 활용해 여러 데이터베이스 인스턴스를 추가할 수 있으며, 로컬과 원격 movies 데이터베이스를 동시에 연결해봅니다.

두 개의 서버 인스턴스를 통해 서로 다른 DB에서 쿼리를 실행하고, ‘wedding gift’ 영화 데이터를 로컬 DB로 복사하는 등 크로스-DB 워크플로우를 시연합니다.

[04:05] 두 데이터베이스 간에 데이터를 이동시키는 실용적인 사용 사례를 보여줍니다. Wedding Gift 영화 데이터를 원격에서 로컬 데이터베이스로 복사합니다.

[04:37] 데이터베이스 간 데이터 이동 및 조합이 가능함을 확인하고 Neo4j MCP 서버의 유용성을 마무리합니다.

Neo4j의 Cypher MCP 서버 활용 과정을 요약하며, AI 에이전트 기반 자연어 제어의 유용성을 강조합니다. 다음 영상 예고와 함께 마무리 인사를 전합니다.

타임라인 정보가 없습니다.

[00:00] 안녕하세요 여러분. 오늘은 Neo4j의

[00:02] Cypher MCP 서버에 대한

[00:04] 전체 영상을 만들어보려고 합니다. 혹시 아직 모르시는 분들을 위해 설명드리면,

[00:07] MCP 서버 또는 모델 컨텍스트 프로토콜

[00:10] 서버는 AI 에이전트가 다른

[00:12] 시스템과 더 쉽게 인터페이스할 수 있게 해주는

[00:14] 도구입니다. 특히 Cypher MCP

[00:17] 서버의 경우, 하나 또는 여러 개의 Neo4j 데이터베이스를

[00:20] 기존 AI 에이전트나 커서, 윈드서프, 클로드 데스크톱 같은

[00:23] AI 도구와 함께 작업할 수 있게 해줍니다. 왜

[00:26] 이 특정 서버를 사용하고 싶을까요?

[00:30] 첫째, Cypher라는 그래프 쿼리 언어를 배울 필요가 없고

[00:32] 그래프 데이터 모델에 대해서도

[00:35] 전혀 알 필요가 없습니다.

[00:37] 에이전트가 Cypher 작성을 대신 처리해주기 때문입니다.

[00:39] 자연어 프롬프트나 질문,

[00:42] 명령을 받아서 Cypher

[00:44] 문으로 변환하여 데이터베이스와

[00:46] 인터페이스합니다.

[00:48] 그리고 기존 데이터 모델이 있거나

[00:50] 새로 생성해야 하는 경우에도

[00:52] 에이전트가 이를 관리해줍니다.

[00:54]

[00:56] 이 특정 서버에는 세 가지

[00:58] 도구만 있습니다. 첫 번째는 get neo4j schema입니다.

[01:01] 이는 데이터베이스에 이미 존재하는

[01:04] 데이터 모델 스키마를 가져옵니다.

[01:06] 노드가 어떤 타입인지,

[01:08] 관계의 타입들, 노드의

[01:10] 속성들, 관계의 속성들 등

[01:12] 모든 정보가 에이전트에게 제공됩니다. 다음으로

[01:15] read Neo4j cipher가 있습니다. 이름 그대로

[01:17] Neo4j 데이터베이스에서 데이터를

[01:19] 읽는 용도입니다. 마지막으로

[01:21] write Neo4j cipher가 있는데 이는

[01:24] 데이터베이스에 데이터를 쓰는 용도입니다.

[01:27] 이 서버는 두 가지 플랫폼에서 실행할 수 있습니다.

[01:30] 첫 번째는 가상 환경 및 종속성 관리

[01:32] 서비스인 astral uv이고

[01:34] Docker 컨테이너에서도 서버를 실행할 수 있으며

[01:37] 이 경우 docker 명령어를 사용하면 됩니다.

[01:39] 물론 이 두 시스템 중

[01:41] 하나 또는 다른 하나가 대상

[01:43] 기기에서 실행되어야 합니다. 랩톱에서 작업한다면

[01:47] UV 방식을 선택할 경우

[01:48] UV가 설치되어 있어야 하고,

[01:50] Docker를 사용한다면

[01:51] 해당 옵션을 실행하기 위해

[01:53] Docker가 설치되어 있어야 합니다.

[01:56] 이제 GitHub Copilot이 있는 Visual Studio Code로

[01:58] 넘어가보겠습니다. 로컬에서

[01:59] 설정해보겠습니다.

[02:01] 새로운 VS Code 폴더를 만들고

[02:04]

[02:06] MCP.json 파일을 생성하겠습니다.

[02:10] MCP Neo4j cipher 저장소로 가시면

[02:12] 아래로 스크롤하면

[02:14] MCP 서버 설정의

[02:17] 예시가 있습니다.

[02:23] 이것은 모두 여는 중괄호와

[02:25] 닫는 중괄호 안에 있어야 합니다.

[02:27] 그리고 Visual Studio Code의 경우

[02:30] servers여야 합니다.

[02:33] 좋습니다. 올바른 자격 증명을 붙여넣고

[02:34] 추가한 후에는

[02:36] 여기에 있는 작은 텍스트 버튼을

[02:38] 클릭할 수 있습니다.

[02:40] 여기서 시작을 클릭하면 됩니다. 실행이 되면

[02:43] 채팅 창으로 가서

[02:45] 데이터베이스와 인터페이스를 시작할 수 있습니다.

[02:47] 제 데이터베이스가 비어있기 때문에

[02:50] JSON이라는 이름의 노드를

[02:52] 추가해달라고 요청해보겠습니다.

[02:59] 좋습니다. 추가되었다고 나오네요.

[03:01] 데이터베이스를 빠르게 확인해서

[03:03] 실제로 그런지 보겠습니다.

[03:06] 정말 그렇네요. 좋습니다. 간단한 사용 사례입니다.

[03:09] Cipher 서버가 네임스페이스로 되어있기 때문에

[03:13] 실제로 여기에 여러 인스턴스를

[03:15] 추가할 수 있습니다. 이것을 복사해서

[03:20] 다른 로컬 데이터베이스 대신

[03:22] 원격 movies 데이터베이스에

[03:25] 연결할 수 있습니다. 이

[03:27] 읽기 전용 데이터베이스의 자격 증명은

[03:30] readme에도 있습니다.

[03:32] 여기서 가져오겠습니다.

[03:38] 여기서 네임스페이스가

[03:40] movies라고 되어있는 것을 볼 수 있고

[03:41] 여기에도 추가할 수 있습니다. 이제

[03:44] 이 데이터베이스도 시작할 수 있습니다.

[03:47] movies를 시작하겠습니다.

[03:49] 가장 최신 영화가 무엇인가요?

[04:05] The Wedding Gift이 오래된 영화

[04:08] 데이터셋이라고 하네요. 이제 서버를 통해

[04:10] 두 개의 서로 다른 데이터베이스에 접근하고 있으므로

[04:13] 실제로 데이터를

[04:15] 이동시키는 것 같은 작업을 할 수 있습니다.

[04:17] The Wedding Gift

[04:20] 영화 데이터를 내 로컬 데이터베이스에

[04:23] 추가해보겠습니다.

[04:37] 좋습니다. 여기에 노드가

[04:38] 나타난 것을 볼 수 있습니다. 데이터베이스 간에

[04:40] 흥미로운 조합을

[04:41] 시작할 수 있는 곳을 볼 수 있습니다.

[04:43] 데이터를 가져와서 추가하고

[04:45] 이동시킬 수 있습니다.

[04:47] Neo4j의

[04:49] MCP Neo4j Cipher 서버에 대한 빠른 소개와

[04:53] 할 수 있는 작업들이었습니다.

[04:55] 제 이름은 Jason Coup입니다. 시청해주셔서 감사합니다.

[04:57] 도움이 되었기를 바라며

[04:59] 다음 영상에서 뵙겠습니다.