Neo4j MCP Server
by alvaropaco
README.md
# Neo4j MCP Server
MCP server para operações abstratas de grafos Neo4j.
## Deploy
```bash
# Build
cd neo4j-mcp && docker build -t neo4j-mcp:latest .
# Import to k3s
docker save neo4j-mcp:latest | k3s ctr images import -
# Apply (password set via existing K8s secret or env)
kubectl apply -f k8s/deployment.yaml
# Or set password directly:
kubectl create secret generic neo4j-mcp-secrets \
--namespace=openclaw-instance-1 \
--from-literal=NEO4J_URI=bolt://openclaw-instance-1-neo4j:7687 \
--from-literal=NEO4J_USER=neo4j \
--from-literal=NEO4J_PASSWORD=<your-password> \
--dry-run=client -o yaml | kubectl apply -f -
```
## Tools
| Tool | Description |
|------|-------------|
| `neo4j_search` | Search nodes by label/properties or free-text |
| `neo4j_insert` | Create a node |
| `neo4j_update` | Update node properties |
| `neo4j_delete` | Delete nodes |
| `neo4j_schema` | Introspect schema |
| `neo4j_query` | Raw Cypher queries |
| `neo4j_search_relationships` | Search relationships |
| `neo4j_insert_relationship` | Create a relationship |
## Security
⚠️ **Never commit real passwords.** The deployment manifest uses a placeholder `${NEO4J_PASSWORD}`. Set the actual password via Kubernetes secrets.TDQS
A4.1/5.0
Scored across 8 tools
Disambiguation5/5
Each tool has a distinct purpose: create, read, update, delete operations for nodes and relationships, schema introspection, and raw query execution. No two tools overlap in functionality.
Naming Consistency5/5
All tools follow the consistent `neo4j_<verb>` pattern in snake_case, with verbs like delete, insert, search, update, etc. The pattern is predictable and easy to understand.
Tool Count5/5
8 tools cover the essential operations for a Neo4j database (CRUD, query, schema, search, relationship management) without being excessive or insufficient.
Completeness5/5
The toolset provides comprehensive coverage: node CRUD, relationship creation, update, search (by label/properties or free-text), relationship search, schema introspection, and raw Cypher for anything missing.
Maintenance
ActivityMaintained
ResponsivenessNo issues