mcp-neo4j-memory SSE Support, docker stdio/sse images, extensive test coverage

[mlesyk]

Tested sse/stdio with LibreChat integration and Claude Desktop

Key Features

✅ Multiple protocols: stdio (Claude Desktop) + SSE (streaming apps)
✅ Tested with LibreChat integration, with Claude Desktop SSE and STDIO options
✅ Extensive test coverage with ability to run isolated on docker
✅ Production ready docker images
✅ Easy integration: LibreChat, Claude Desktop, or standalone

Quick Start on local machine

# Setup env
uv venv
.venv\Scripts\activate
uv pip install -e ".[dev]"

# Set environment for tests
set NEO4J_URL=neo4j://localhost:7687
set NEO4J_USERNAME=neo4j
set NEO4J_PASSWORD=testpassword

# Run neo4j
docker run -d --name neo4j-test -p 7687:7687 -p 7474:7474 -e NEO4J_AUTH=neo4j/testpassword neo4j:latest

# Run tests
uv run pytest

# Run STDIO mode mcp_neo4j_memory
python -m mcp_neo4j_memory

# Run SSE mode mcp_neo4j_memory
python -m mcp_neo4j_memory --mode sse --port 3001

# Alternative
python -m mcp_neo4j_memory \
  --mode sse \
  --db-url neo4j://localhost:7687 \
  --username neo4j \
  --password your_password \
  --port 3001

Quick Start with Docker

# 1. Build and run tests, clean
./scripts/test.sh build
./scripts/test.sh
./scripts/test.sh clean

# 2. Build Docker images 
./scripts/build.sh all

# Run neo4j
docker run -d --name neo4j-test -p 7687:7687 -p 7474:7474 -e NEO4J_AUTH=neo4j/testpassword neo4j:latest

# Run mcp-neo4j-memory image in stdio mode
docker run -it -p 3001:3001 -e NEO4J_URL=bolt://host.docker.internal:7687 -e NEO4J_USERNAME=neo4j -e NEO4J_PASSWORD=testpassword mcp-neo4j-memory:latest

# Run mcp-neo4j-memory image in sse mode
docker run -it -p 3001:3001 -e NEO4J_URL=bolt://host.docker.internal:7687 -e NEO4J_USERNAME=neo4j -e NEO4J_PASSWORD=testpassword mcp-neo4j-memory:sse

# 3. Publish Docker images 
./scripts/publish.sh

See Usage examples in `examples` directory

Try run using my docker image from dockerhub
# Run mcp-neo4j-memory image in stdio mode
docker run -it -p 3001:3001 -e NEO4J_URL=bolt://host.docker.internal:7687 -e NEO4J_USERNAME=neo4j -e NEO4J_PASSWORD=testpassword lesykm/mcp-neo4j-memory:latest

# Run mcp-neo4j-memory image in sse mode
docker run -it -p 3001:3001 -e NEO4J_URL=bolt://host.docker.internal:7687 -e NEO4J_USERNAME=neo4j -e NEO4J_PASSWORD=testpassword lesykm/mcp-neo4j-memory:sse