cypher - update docker docs, add workflow image and desc (#147)

Author: a-s-g93

servers/mcp-neo4j-cypher/README.md

@@ -2,7 +2,18 @@
 
 ## 🌟 Overview
 
-A Model Context Protocol (MCP) server implementation that provides database interaction and allows graph exploration capabilities through Neo4j. This server enables running Cypher graph queries, analyzing complex domain data, and automatically generating business insights that can be enhanced with Claude's analysis.
+A Model Context Protocol (MCP) server implementation that provides database interaction and allows graph exploration capabilities through Neo4j. This server enables running Cypher graph queries, analyzing complex domain data, and automatically generating business insights that can be enhanced further with an application's analysis tools.
+
+This MCP server facilitates Text2Cypher workflows like the one detailed below. 
+
+* Blue steps are handled by the agent
+* Purple by the Cypher or another MCP server
+* Green by the user
+
+A user question is input to the process and the output is an answer generated by the agent.
+
+![text2cypher-workflow](./assets/images/text2cypher-process.png)
+
 
 ## 🧩 Components
 
@@ -47,7 +58,7 @@ This is useful when you need to connect to multiple Neo4j databases or instances
 Build and run locally for testing or remote deployment:
 
 ```bash
-# Build the Docker image with a custom name
+# Build the Docker image with a custom name from your local version of the server
 docker build -t mcp-neo4j-cypher:latest .
 
 # Run locally (uses http transport by default for Docker)
@@ -87,15 +98,17 @@ Can be found on PyPi https://pypi.org/project/mcp-neo4j-cypher/
 Add the server to your `claude_desktop_config.json` with the database connection configuration through environment variables. You may also specify the transport method and namespace with cli arguments or environment variables.
 
 ```json
-"mcpServers": {
-  "neo4j-database": {
-    "command": "uvx",
-    "args": [ "[email protected]", "--transport", "stdio"  ],
-    "env": {
-      "NEO4J_URI": "bolt://localhost:7687",
-      "NEO4J_USERNAME": "neo4j",
-      "NEO4J_PASSWORD": "<your-password>",
-      "NEO4J_DATABASE": "neo4j"
+{
+  "mcpServers": {
+    "neo4j-database": {
+      "command": "uvx",
+      "args": [ "[email protected]", "--transport", "stdio"  ],
+      "env": {
+        "NEO4J_URI": "bolt://localhost:7687",
+        "NEO4J_USERNAME": "neo4j",
+        "NEO4J_PASSWORD": "<your-password>",
+        "NEO4J_DATABASE": "neo4j"
+      }
     }
   }
 }
@@ -190,32 +203,43 @@ Syntax with `--db-url`, `--username`, `--password` and other command line argume
 
 ### 🐳 Using with Docker
 
+Here we use the Docker Hub hosted Cypher MCP server image with stdio transport for use with Claude Desktop.
+
+**Config details:**
+* `-i`: Interactive mode - keeps STDIN open for stdio transport communication
+* `--rm`: Automatically remove container when it exits (cleanup)
+* `-p 8000:8000`: Port mapping - maps host port 8000 to container port 8000 
+* `NEO4J_TRANSPORT=stdio`: Uses stdio transport for Claude Desktop compatibility
+* `NEO4J_NAMESPACE=neo4j`: Prefixes tools with "neo4j-" (e.g., `neo4j-read_neo4j_cypher`)
+* `NEO4J_URI=bolt://host.docker.internal:7687`: Allows Docker container to connect to Neo4j running on host machine
+
 ```json
-"mcpServers": {
-  "neo4j": {
-    "command": "docker",
-    "args": [
-      "run",
-      "--rm",
-      "-e", "NEO4J_URI=bolt://host.docker.internal:7687",
-      "-e", "NEO4J_USERNAME=neo4j",
-      "-e", "NEO4J_PASSWORD=<your-password>",
-      "-e", "NEO4J_NAMESPACE=mydb",
-      "-e", "NEO4J_TRANSPORT=http",
-      "-e", "NEO4J_MCP_SERVER_HOST=0.0.0.0",
-      "-e", "NEO4J_MCP_SERVER_PORT=8000",
-      "-e", "NEO4J_MCP_SERVER_PATH=/api/mcp/",
-      "mcp/neo4j-cypher:latest"
-    ]
+{
+  "mcpServers": {
+    "neo4j": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-p", 
+        "8000:8000",
+        "-e", "NEO4J_URI=bolt://host.docker.internal:7687",
+        "-e", "NEO4J_USERNAME=neo4j",
+        "-e", "NEO4J_PASSWORD=password",
+        "-e", "NEO4J_NAMESPACE=neo4j",
+        "-e", "NEO4J_TRANSPORT=stdio",
+        "mcp/neo4j-cypher:latest"
+      ]
+    }
   }
 }
 ```
 
-**Note**: This assumes you've built the image locally with `docker build -t mcp-neo4j-cypher:latest .`. Docker transport defaults to HTTP mode.
 
 ## 🐳 Docker Deployment
 
-The Neo4j MCP server can be deployed using Docker for remote deployments. Docker deployment uses HTTP transport by default for web accessibility.
+The Neo4j MCP server can be deployed using Docker for remote deployments. Docker deployment uses HTTP transport by default for web accessibility. In order to integrate this deployment with applications like Claude Desktop, you will have to use a proxy in your MCP configuration such as `mcp-remote`.
 
 ### 📦 Using Your Built Image
 
@@ -231,7 +255,7 @@ docker run --rm -p 8000:8000 \
   -e NEO4J_TRANSPORT="http" \
   -e NEO4J_MCP_SERVER_HOST="0.0.0.0" \
   -e NEO4J_MCP_SERVER_PORT="8000" \
-  -e NEO4J_MCP_SERVER_PATH="/api/mcp/" \
+  -e NEO4J_MCP_SERVER_PATH="/mcp/" \
   mcp/neo4j-cypher:latest
 ```
 
@@ -243,9 +267,9 @@ docker run --rm -p 8000:8000 \
 | `NEO4J_USERNAME`        | `neo4j`                                 | Neo4j username                                 |
 | `NEO4J_PASSWORD`        | `password`                              | Neo4j password                                 |
 | `NEO4J_DATABASE`        | `neo4j`                                 | Neo4j database name                            |
-| `NEO4J_TRANSPORT`       | `stdio` (local), `http` (Docker)        | Transport protocol (`stdio`, `http`, or `sse`) |
+| `NEO4J_TRANSPORT`       | `stdio` (local), `http` (remote)        | Transport protocol (`stdio`, `http`, or `sse`) |
 | `NEO4J_NAMESPACE`       | _(empty)_                               | Tool namespace prefix                          |
-| `NEO4J_MCP_SERVER_HOST` | `127.0.0.1` (local), `0.0.0.0` (Docker) | Host to bind to                                |
+| `NEO4J_MCP_SERVER_HOST` | `127.0.0.1` (local)                     | Host to bind to                                |
 | `NEO4J_MCP_SERVER_PORT` | `8000`                                  | Port for HTTP/SSE transport                    |
 | `NEO4J_MCP_SERVER_PATH` | `/api/mcp/`                             | Path for accessing MCP server                  |
 
@@ -332,7 +356,7 @@ For Claude Desktop integration with a Dockerized server using http transport:
 }
 ```
 
-**Note**: First start your Docker container with HTTP transport, then Claude Desktop can connect to it via the HTTP endpoint.
+**Note**: First start your Docker container with HTTP transport, then Claude Desktop can connect to it via the HTTP endpoint and proxy server like `mcp-remote`.
 
 ## 🚀 Development