@@ -41,12 +41,52 @@ Add the server to your `claude_desktop_config.json` with configuration of:
4141* username
4242* password
4343
44+
45+ Alternatively, you can set environment variables:
46+
47+ ``` json
48+ "mcpServers" : {
49+ "neo4j-aura" : {
50+ "command" : " uvx" ,
51+ "args" : [ " mcp-neo4j-cypher==0.1.2" ],
52+ "env" : {
53+ "NEO4J_URL" : " bolt://localhost:7687" ,
54+ "NEO4J_USERNAME" : " neo4j" ,
55+ "NEO4J_PASSWORD" : " <your-password>"
56+ }
57+ }
58+ }
59+ ```
60+
61+ Here is an example connection for the movie database with Movie, Person (Actor, Director), Genre, User and ratings:
62+
63+ ``` json
64+ {
65+ "mcpServers" : {
66+ "movies-neo4j" : {
67+ "command" : " uvx" ,
68+ "args" : [" mcp-neo4j-cypher==0.1.2" ],
69+ "env" : {
70+ "NEO4J_URL" : " neo4j+s://demo.neo4jlabs.com" ,
71+ "NEO4J_USERNAME" : " recommendations" ,
72+ "NEO4J_PASSWORD" : " recommendations"
73+ }
74+ }
75+ }
76+ }
77+ ```
78+
79+ Syntax with ` --db-url ` , ` --username ` and ` --password ` was supported but will be removed in future versions:
80+
81+ <details >
82+ <summary >Legacy Syntax</summary >
83+
4484``` json
4585"mcpServers" : {
4686 "neo4j" : {
4787 "command" : " uvx" ,
4888 "args" : [
49- " mcp-neo4j-cypher" ,
89+ " mcp-neo4j-cypher==0.1.2 " ,
5090 " --db-url" ,
5191 " bolt://localhost" ,
5292 " --username" ,
@@ -65,14 +105,15 @@ Here is an example connection for the movie database with Movie, Person (Actor,
65105 "mcpServers" : {
66106 "movies-neo4j" : {
67107 "command" : " uvx" ,
68- "args" : [" mcp-neo4j-cypher" ,
108+ "args" : [" mcp-neo4j-cypher==0.1.2 " ,
69109 " --db-url" , " neo4j+s://demo.neo4jlabs.com" ,
70110 " --user" , " recommendations" ,
71111 " --password" , " recommendations" ]
72112 }
73113 }
74114}
75115```
116+ </details >
76117
77118### 🐳 Using with Docker
78119
@@ -86,7 +127,7 @@ Here is an example connection for the movie database with Movie, Person (Actor,
86127 " -e" , " NEO4J_URL=bolt://host.docker.internal:7687" ,
87128 " -e" , " NEO4J_USERNAME=neo4j" ,
88129 " -e" , " NEO4J_PASSWORD=<your-password>" ,
89- " mcp/neo4j-cypher:0.1.1 "
130+ " mcp/neo4j-cypher:0.1.2 "
90131 ]
91132 }
92133}
@@ -131,17 +172,13 @@ uv pip install -e ".[dev]"
131172 "neo4j" : {
132173 "command" : " uv" ,
133174 "args" : [
134- " --directory" ,
135- " parent_of_servers_repo/servers/src/neo4j" ,
136- " run" ,
137- " mcp-neo4j-cypher" ,
138- " --db-url" ,
139- " bolt://localhost" ,
140- " --username" ,
141- " neo4j" ,
142- " --password" ,
143- " <your-password>"
144- ]
175+ " --directory" , " parent_of_servers_repo/servers/src/neo4j" ,
176+ " run" , " mcp-neo4j-cypher" ],
177+ "env" : {
178+ "NEO4J_URL" : " bolt://localhost" ,
179+ "NEO4J_USERNAME" : " neo4j" ,
180+ "NEO4J_PASSWORD" : " <your-password>"
181+ }
145182 }
146183}
147184```
@@ -152,13 +189,13 @@ Build and run the Docker container:
152189
153190``` bash
154191# Build the image
155- docker build -t mcp/neo4j-cypher:0.1.1 .
192+ docker build -t mcp/neo4j-cypher:latest .
156193
157194# Run the container
158195docker run -e NEO4J_URL=" bolt://host.docker.internal:7687" \
159196 -e NEO4J_USERNAME=" neo4j" \
160197 -e NEO4J_PASSWORD=" your-password" \
161- mcp/neo4j-cypher:0.1.1
198+ mcp/neo4j-cypher:latest
162199```
163200
164201## 📄 License
0 commit comments