Neo4j MCP 서버

모델 컨텍스트 프로토콜을 통해 그래프 데이터베이스 작업을 관리하기 위한 Neo4j MCP 서버 구현입니다.

🔌 Cursor와 Claude Desktop 모두와 호환됩니다!

빠른 시작

npx를 사용하여 서버를 직접 실행할 수 있습니다.

지엑스피1

Related MCP server: Neo4j MCP Server

설치

패키지를 글로벌하게 설치하려면 다음을 수행하세요.

npm install -g neo4j-mcpserver

그런 다음 실행합니다.

NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password neo4j-mcpserver

환경 변수

Neo4j 연결 세부 정보는 두 가지 방법으로 제공할 수 있습니다.

1. 단일 연결 문자열 사용:

   NEO4J_CONNECTION=<uri>,<user>,<password>

2. 별도의 환경 변수 사용:

   NEO4J_URI=<your-uri>
   NEO4J_USER=<your-user>
   NEO4J_PASSWORD=<your-password>

프로젝트 루트에서 .env 파일을 사용할 수도 있습니다.

NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password

구성 ⚙️

커서 구성 🖥️

Cursor에서 Neo4j MCP 서버를 설정하려면:

1. 커서 설정 열기

2. 기능 > MCP 서버로 이동

3. "+ 새 MCP 서버 추가" 버튼을 클릭하세요

4. 다음 정보를 입력하세요:

   • 이름: 서버의 별명을 입력하세요(예: "neo4j-mcp")

   • 유형: 유형으로 "명령"을 선택하세요

   • 명령어: 서버를 실행하기 위한 명령어를 입력하세요: GXP7

   중요: 자격 증명을 실제 Neo4j 데이터베이스 자격 증명으로 바꾸세요.

사용 가능한 도구 🛠️

neo4j-쿼리

Neo4j 데이터베이스에 대해 Cypher 쿼리를 실행합니다.

Cursor에서의 사용 예:

MATCH (n) RETURN n LIMIT 5

문제 해결 🔧

문제가 발생하는 경우:

1. Neo4j 자격 증명 확인

   • Neo4j URI, 사용자 이름 및 비밀번호가 올바른지 확인하세요.

   • Neo4j 데이터베이스에 액세스할 수 있는지 확인하세요.

2. 경로 문제

   • 설치 경로에 공백이 없는지 확인하세요.

   • 경로에 슬래시(/)를 사용하세요

3. 도구 감지 문제

   • 커서를 다시 시작해 보세요

   • 서버가 실행 중인지 확인하세요(Cursor의 MCP 서버 목록 확인)

   • 환경 변수가 올바르게 설정되었는지 확인하세요

개발 👩‍💻

로컬로 실행하려면:

git clone <repository-url>
cd neo4j-mcpserver
npm install
npm run build
npm start

특허

아이에스씨