Neo4j MCPはAIアシスタントやLLM搭載ツールに、Neo4jグラフデータベースへの直接的かつ構造化されたアクセスを提供します。 Model Context Protocol(MCP)を実装することで、Claude、Cursor、VS Codeなどの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).