Skip to main content
Glama
alvaropaco

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