read-neo4j-cypherLABSCO SUMMARY
Graph queries with the schema one call away.
Writing Cypher against an unfamiliar graph is guesswork until the node types and their relationships are visible, which is exactly what the schema tool returns. Reads and writes sit on separate tools, so a mutation is always a deliberate choice.
What it is
A Python MCP server for Neo4j that runs read and write Cypher against a database selected on the command line, over Server-Sent Events or stdio.
What you get
- Read queries executed, with results returned as an array of objects
- Write queries on a separate tool, returning a summary counter of nodes updated and relationships created
- The whole schema listed: every node type with its attributes, their names and types, and its relationships to other node types
- Remote databases selectable at launch, with SSE bound to a default host and port
- A demo prompt that walks through generating a schema and sample data
Requirements
Python 3.12+ and pip install -r requirements.txt, then launch it with the database's address, the account to connect as, that account's password, and --database for which database to open. Neo4j must be running and reachable for remote connections.
Setup effort
Build from source — git clone https://github.com/dsimile/mcp-neo4j-server-sse.git
USE CASES
01
Finding out what is in a graph you did not build
List the node types, their attributes and how they connect before writing anything.
02
Answering a question that spans relationships
Run the read query and get objects back, rather than exporting to work on elsewhere.
03
Loading or correcting data
Use the write tool and read the counter of what actually changed.
04
Pointing the same server at a different database
Relaunch against another --database rather than maintaining a second server entry.
3 tools
Listed in project docs. Your client may show a different list.
write-neo4j-cypherget-neo4j-schemaBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
Python 3.12+
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/dsimile/mcp-neo4j-server-sse.gitHave Python 3.12+ available
TERMINAL
cd mcp-neo4j-server-sse
pip install -r requirements.txtMake sure Neo4j is running and reachable, then start the server in SSE mode (default 0.0.0.0:8543) from the same Python environment you installed the requirements into, or skip this and add the STDIO config block to cline_mcp_settings.json:
TERMINAL
uv run src/mcp-neo4j-cypher/neo4j_server_remote.py --url bolt://localhost:7687 --username neo4j --password neo4j123 --database neo4jMCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"neo4j-local": {
"disabled": false,
"timeout": 60,
"command": "uv",
"args": [
"run",
"<YOUR_PATH_TO_NEO4J_SERVER_REMOTE>",
"--url",
"bolt://localhost:7687",
"--username",
"neo4j",
"--password",
"neo4j123",
"--database",
"neo4j",
"--mode",
"stdio"
]
}
}
}
