neo4j-server-remote

What is neo4j-server-remote?

neo4j-server-remote is a Model Context Protocol (MCP) server that provides database interaction and graph exploration capabilities through Neo4j. It uses Server-Sent Events (SSE) or STDIO as the transport protocol and enables execution of Cypher queries and analysis of complex domain data via remotely accessible databases. It is intended for developers integrating Neo4j with MCP‑compatible clients like Cline.

How to use neo4j-server-remote?

Clone the repository, ensure Python 3.12+ is installed, and run pip install -r requirements.txt. The server can be started in SSE mode (default) or STDIO mode using uv run with the appropriate Neo4j connection arguments (e.g., --url bolt://localhost:7687 --username neo4j --password neo4j123 --database neo4j). For client configuration, add the server entry to your cline_mcp_settings.json, specifying either the SSE URL or the STDIO command/args.

Key features of neo4j-server-remote

• Two transport modes: SSE (default) and STDIO
• Execute Cypher read queries with read-neo4j-cypher
• Execute updating queries with write-neo4j-cypher
• Retrieve graph schema via get-neo4j-schema
• Demo prompt mcp-demo for guided database operations
• Supports selecting remotely accessible Neo4j databases

Use cases of neo4j-server-remote

• Running read‑only Cypher queries to retrieve graph data
• Performing write operations (create/update nodes and relationships)
• Inspecting the schema of all node types, their attributes, and relationships
• Using the interactive demo prompt to explore the database interactively
• Integrating Neo4j graph analysis into an MCP‑enabled AI agent workflow

FAQ from neo4j-server-remote

What transport protocols does neo4j-server-remote support?

It supports Server‑Sent Events (SSE) as the default transport and STDIO as an alternative mode.

What tools does neo4j-server-remote provide?

Three core tools: read-neo4j-cypher (execute read queries), write-neo4j-cypher (execute update queries), and get-neo4j-schema (retrieve node types, attributes, and relationships).

What are the runtime prerequisites?

Python 3.12 or later and the dependencies listed in requirements.txt. Neo4j must be running and accessible for remote connections.

How do I configure it for the Cline client?

Add an entry to cline_mcp_settings.json. For SSE mode use "url": "http://0.0.0.0:8543/sse"; for STDIO mode specify the uv run command and arguments with mode set to stdio.

Is there a demo prompt available?

Yes, the server includes a prompt called mcp-demo that guides users through database operations and generates appropriate schemas and sample data.