Merge pull request #77 from neo4j-contrib/cypher-prep-v0.2.4

update changelog, readme, version, add example docker-compose.yml file

Author: a-s-g93

servers/mcp-neo4j-cypher/CHANGELOG.md

@@ -1,10 +1,16 @@
 ## Next
 
 ### Fixed
-* Fixed Cypher MCP Docker deployments by allowing user to declare NEO4J_MCP_SERVER_HOST and NEO4J_MCP_SERVER_PORT. Can now declare NEO4J_MCP_SERVER_HOST=0.0.0.0 to use Docker hosted Cypher MCP server.
 
 ### Changed
 
+### Added
+
+## v0.2.4
+
+### Fixed
+* Fixed Cypher MCP Docker deployments by allowing user to declare NEO4J_MCP_SERVER_HOST and NEO4J_MCP_SERVER_PORT. Can now declare NEO4J_MCP_SERVER_HOST=0.0.0.0 to use Docker hosted Cypher MCP server.
+
 ### Added
 * NEO4J_MCP_SERVER_HOST and NEO4J_MCP_SERVER_PORT env variables
 * --server-host and --server-port cli variables
@@ -15,7 +21,6 @@
 * Namespace option via CLI or env variables. This allows many Cypher MCP servers to be used at once.
 * Allow transport to be specified via env variables
 
-
 ## v0.2.2 
 
 ### Fixed

servers/mcp-neo4j-cypher/README.md

@@ -49,7 +49,7 @@ Add the server to your `claude_desktop_config.json` with the database connection
 "mcpServers": {
   "neo4j-aura": {
     "command": "uvx",
-    "args": [ "[email protected].3", "--transport", "stdio"  ],
+    "args": [ "[email protected].4", "--transport", "stdio"  ],
     "env": {
       "NEO4J_URI": "bolt://localhost:7687",
       "NEO4J_USERNAME": "neo4j",
@@ -69,7 +69,7 @@ Here's an example of connecting to multiple Neo4j databases using namespaces:
   "mcpServers": {
     "movies-neo4j": {
       "command": "uvx",
-      "args": [ "[email protected].3", "--namespace", "movies" ],
+      "args": [ "[email protected].4", "--namespace", "movies" ],
       "env": {
         "NEO4J_URI": "neo4j+s://demo.neo4jlabs.com",
         "NEO4J_USERNAME": "recommendations",
@@ -79,7 +79,7 @@ Here's an example of connecting to multiple Neo4j databases using namespaces:
     },
     "local-neo4j": {
       "command": "uvx",
-      "args": [ "[email protected].3" ],
+      "args": [ "[email protected].4" ],
       "env": {
         "NEO4J_URI": "bolt://localhost:7687",
         "NEO4J_USERNAME": "neo4j",
@@ -103,7 +103,7 @@ Here is an example connection for the movie database with Movie, Person (Actor,
   "mcpServers": {
     "movies-neo4j": {
       "command": "uvx",
-      "args": [ "[email protected].3" ],
+      "args": [ "[email protected].4" ],
       "env": {
         "NEO4J_URI": "neo4j+s://demo.neo4jlabs.com",
         "NEO4J_USERNAME": "recommendations",
@@ -125,7 +125,7 @@ Syntax with `--db-url`, `--username`, `--password` and other command line argume
   "neo4j": {
     "command": "uvx",
     "args": [
-      "[email protected].3",
+      "[email protected].4",
       "--db-url",
       "bolt://localhost",
       "--username",
@@ -152,7 +152,7 @@ Here is an example connection for the movie database with Movie, Person (Actor,
   "mcpServers": {
     "movies-neo4j": {
       "command": "uvx",
-      "args": ["[email protected].3", 
+      "args": ["[email protected].4", 
       "--db-url", "neo4j+s://demo.neo4jlabs.com", 
       "--user", "recommendations", 
       "--password", "recommendations",

servers/mcp-neo4j-cypher/docker-compose.yml

@@ -0,0 +1,31 @@
+services:
+  # Deploy Neo4j Database (optional)
+  neo4j:
+    image: neo4j:5.26.1 # or another version
+    environment:
+      - NEO4J_AUTH=neo4j/password
+    ports:
+      - "7474:7474"
+      - "7687:7687"
+    volumes:
+      - neo4j_data:/data
+
+  # Deploy Cypher MCP Server
+  mcp-neo4j-cypher-server:
+    image: mcp/neo4j-cypher:latest
+    ports:
+      - "8000:8000"
+    environment:
+      - NEO4J_URI=bolt://host.docker.internal:7687
+      - NEO4J_USERNAME=neo4j
+      - NEO4J_PASSWORD=password
+      - NEO4J_DATABASE=neo4j
+      - NEO4J_TRANSPORT=sse
+      - NEO4J_MCP_SERVER_HOST=0.0.0.0 # must be 0.0.0.0 for sse transport in Docker
+      - NEO4J_MCP_SERVER_PORT=8000
+      - NEO4J_NAMESPACE=local
+    depends_on:
+      - neo4j
+
+volumes:
+  neo4j_data: 

servers/mcp-neo4j-cypher/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcp-neo4j-cypher"
-version = "0.2.3"
+version = "0.2.4"
 description = "A simple Neo4j MCP server"
 readme = "README.md"
 requires-python = ">=3.10"