neo4j-server-remote

What is neo4j-server-remote?

neo4j-server-remote is a Model Context Protocol (MCP) server that enables AI assistants to interact with a remote Neo4j graph database using Server-Sent Events (SSE) as the transport protocol. It provides Cypher query execution and schema exploration tools for developers building graph‑powered AI applications.

How to use neo4j-server-remote?

Clone the repository, install Python 3.12+ and dependencies (pip install -r requirements.txt), then run the server with uv run providing the Neo4j connection details (URL, username, password, database). Add it to your Cline client’s cline_mcp_settings.json with the SSE URL (default http://0.0.0.0:8543/sse).

Key features of neo4j-server-remote

• Execute Cypher read queries to retrieve graph data.
• Execute Cypher write queries to update the database.
• Retrieve graph schema (node labels, attributes, relationships).
• Demonstration prompt (mcp-demo) for guided database operations.
• Uses SSE transport for remote connectivity.
• Inspired by the official Neo4j MCP Cypher server.

Use cases of neo4j-server-remote

• Enabling an AI assistant to explore and query a remote Neo4j knowledge graph.
• Automating data‑driven decisions by executing Cypher queries through natural language.
• Building conversational interfaces that can inspect and modify graph database schemas.

FAQ from neo4j-server-remote

What dependencies does neo4j-server-remote require?

Python 3.12+ and the packages listed in requirements.txt. The Neo4j database must be running and accessible at the provided Bolt URL.

How do I configure the server for remote access?

Run the server with --url, --username, --password, and --database flags. The default host is 0.0.0.0 and port 8543. Add the SSE endpoint to your MCP client’s settings JSON.

What tools does neo4j-server-remote expose?

Three query/schema tools: read-neo4j-cypher, write-neo4j-cypher, and get-neo4j-schema. It also provides an interactive prompt named mcp-demo.

Does neo4j-server-remote support authentication or authorization?

The README does not mention any authentication or authorization beyond the Neo4j credentials passed at startup.

What is the license for neo4j-server-remote?

It is licensed under the MIT License.