Neo4j MCP는 AI 어시스턴트와 LLM 기반 도구에 Neo4j 그래프 데이터베이스에 직접적이고 구조화된 접근을 제공합니다. 모델 컨텍스트 프로토콜(MCP)을 구현함으로써, Claude, 커서, VS 코드 등 MCP 호환 클라이언트와 Neo4j 인스턴스 간의 다리 역할을 합니다.

특징

• 그래프 스키마 탐색 - 노드 라벨, 관계 유형, 속성 키를 발견하기
• 사전 지식 없이 AI가 데이터 모델에 대해 추론하게 할 수 있게
• Cypher 쿼리 실행 - 자연어 프롬프트에 응답하여 데이터베이스에 쿼리를 실행, 읽기, 쓰기
• 데이터 검사 및 분석 - 노드, 관계, 경로를 검색하여 질문에 답하거나, 요약을 생성하거나, 다른 워크플로우에 데이터를 공급합니다.

도구

• get-schema — 내성적 라벨, 관계 유형, 속성 키
• read-cypher — EXPLAIN와 Neo4j의 쿼리 유형 분류를 통해 강제되는 데이터베이스 데이터를 수정하지 않는 읽기 전용 암호 쿼리를 실행합니다. 참고: Neo4j에 의해 읽기 전용 분류로 잘못 분류된 사용자 지정 절차나 함수는 이 검사를 우회할 수 있습니다; 올바른 분류를 보장하는 것은 프로시저/함수 유지관리자의 책임입니다.

Neo4j MCP

Neo4j MCP gives AI assistants and LLM-powered tools direct, structured access to your Neo4j graph database. By implementing the Model Context Protocol (MCP), it acts as a bridge between any MCP-compatible client, such as Claude, Cursor, or VS Code with MCP support, and your Neo4j instance.

Features

• Explore your graph schema - discover node labels, relationship types, and property keys
• Let AI reason on your data model without prior knowledge
• Run Cypher queries - execute, read, and write queries against your database in response to natural language prompts
• Inspect and analyze data - retrieve nodes, relationships, and paths to answer questions, generate summaries, or feed data to other workflows

Tools

• get-schema — introspect labels, relationship types, property keys
• read-cypher — execute read-only Cypher queries that do not modify database data, enforced via EXPLAIN and Neo4j’s query-type classification. Note: custom procedures or functions incorrectly classified as read-only by Neo4j may bypass this check; ensuring correct classification is the responsibility of the procedure/function maintainer.
• write-cypher — execute write Cypher queries (disabled if NEO4J_MCP_READ_ONLY=true)
• list-gds-procedures — list available GDS procedures

Installation

Install with PyPI:

pip install neo4j-mcp-server

Otherwise see MCP documentation -> Installation.

Server configuration (VSCode)

Create / edit mcp.json:

{
  "servers": {
    "neo4j": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

See MCP documentation > Configuration for more details.

Links

• Documentation: The official Neo4j MCP documentation.
• Discord: The Neo4j discord channel.
• Contributing Guide: Contribution workflow, development environment, mocks and testing.

For issues and feedback, you can also create a GitHub issue with reproduction details (omit sensitive data).