MCP 문서 관리

메뉴

Neo4j

Neo4j

Neo4j MCP 서버는 LLM이 Neo4j 그래프 데이터베이스와 직접 상호작용할 수 있게 해주는 Model Context Protocol 서버입니다. 그래프 구조에 저장된 데이터를 자연어로 쿼리하고 조작할 수 있는 기능을 제공합니다.

특징

  • Neo4j 그래프 데이터베이스와의 원활한 통합
  • Cypher 쿼리 실행 및 관리
  • 데이터베이스 스키마 검사 및 분석
  • 노드 및 관계 생성, 읽기, 업데이트, 삭제 기능
  • 복잡한 그래프 분석 및 탐색 기능
  • 지식 그래프 기반 메모리 시스템 지원
  • Neo4j Aura 인스턴스 관리 통합

주요 도구

연결 및 탐색 도구

  • connect: Neo4j 데이터베이스에 연결
  • disconnect: 데이터베이스 연결 종료
  • getSchema: 데이터베이스 스키마 검색
  • getDatabaseInfo: 데이터베이스 정보 및 통계 조회

쿼리 실행 도구

  • runCypherQuery: Cypher 쿼리 실행 및 결과 반환
  • explainQuery: 쿼리 실행 계획 및 최적화 정보 제공
  • profileQuery: 쿼리 실행 프로필링 및 성능 분석

그래프 조작 도구

  • createNode: 새 노드 생성
  • createRelationship: 노드 간 관계 생성
  • updateNode: 기존 노드 속성 업데이트
  • deleteNode: 노드 삭제
  • deleteRelationship: 관계 삭제

그래프 분석 도구

  • findPath: 두 노드 간 경로 찾기
  • findNeighbors: 특정 노드의 이웃 노드 찾기
  • findCommunities: 커뮤니티 감지 알고리즘 실행
  • calculateCentrality: 중심성 지표 계산

지식 그래프 메모리 도구

  • storeEntity: 엔티티 정보 저장
  • storeRelationship: 엔티티 간 관계 저장
  • retrieveKnowledge: 저장된 지식 검색
  • fuzzySearch: 유사 개념 및 엔티티 검색

설치 및 사용 방법

Claude Desktop 구성

Claude Desktop에서 Neo4j MCP 서버를 사용하기 위한 구성:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": [
        "-y",
        "neo4j-mcpserver"
      ],
      "env": {
        "NEO4J_URI": "neo4j+s://your-instance.databases.neo4j.io",
        "NEO4J_USER": "neo4j",
        "NEO4J_PASSWORD": "your-password"
      }
    }
  }
}

또는 단일 연결 문자열 사용:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": [
        "-y",
        "neo4j-mcpserver"
      ],
      "env": {
        "NEO4J_CONNECTION": "neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password"
      }
    }
  }
}

지식 그래프 메모리 설정

지식 그래프 기반 메모리 시스템을 위한 구성:

{
  "mcpServers": {
    "neo4j-memory": {
      "command": "/path/to/your/dist/neo4j_mcp_server",
      "args": []
    }
  }
}

Neo4j Aura 인스턴스 관리

Neo4j Aura 클라우드 인스턴스 관리를 위한 도구도 제공됩니다:

  • 인스턴스 목록 조회
  • 새 인스턴스 생성
  • 인스턴스 이름으로 검색
  • 인스턴스 크기 조정
  • 기능 활성화/비활성화

프롬프트 예시

Neo4j MCP 서버와 상호작용하기 위한 예시 프롬프트:

  1. "데이터베이스 스키마를 보여주세요"
  2. "사용자와 제품 간의 모든 관계를 찾아주세요"
  3. "John이라는 이름을 가진 모든 사용자를 검색해주세요"
  4. "두 노드 사이의 최단 경로를 찾아주세요"
  5. "새로운 'Product' 노드를 생성하고 'name' 속성을 'Gaming Laptop'으로 설정해주세요"
  6. "사용자 노드와 제품 노드 사이에 'PURCHASED' 관계를 생성해주세요"
  7. "데이터베이스에서 가장 많은 연결을 가진 노드를 찾아주세요"
  8. "Alice와 Bob 사이의 모든 직접 및 간접 관계를 분석해주세요"

연결된 구성 요소

  • MongoDB - NoSQL 문서 기반 데이터베이스 서버
  • Elasticsearch - 검색 기능이 있는 NoSQL 데이터베이스 서버
  • Redis - 키-값 저장소 데이터베이스 서버
  • PostgreSQL - 강력한 관계형 데이터베이스 서버