Neo4j MCP Server

Fork of the Neo4j Model Context Protocol (MCP) server with environment variable support and improved configuration options.

Features

• Environment variable configuration for Neo4j connection

• Support for custom ports and remote Neo4j instances

• Improved error handling and logging

• Compatible with the Model Context Protocol

Related MCP server: Memgraph MCP Server

Configuration

The server can be configured using the following environment variables:

• NEO4J_URL - Neo4j connection URL (default: "bolt://localhost:7687")

• NEO4J_USER - Neo4j username (default: "neo4j")

• NEO4J_PASSWORD - Neo4j password (default: "neo4j")

Example:

NEO4J_URL="bolt://192.168.0.157:28687" \
NEO4J_USER="neo4j" \
NEO4J_PASSWORD="your-password" \
node dist/servers/mcp-neo4j-memory/main.js

Available Tools

mcp-neo4j-memory

Knowledge graph memory stored in Neo4j with the following capabilities:

• create_entities - Create multiple new entities in the knowledge graph

• create_relations - Create relations between entities (in active voice)

• add_observations - Add new observations to existing entities

• delete_entities - Delete entities and their relations

• delete_observations - Delete specific observations from entities

• delete_relations - Delete specific relations

• read_graph - Read the entire knowledge graph

• search_nodes - Search for nodes based on a query

• open_nodes - Open specific nodes by their names

Development

# Install dependencies
npm install

# Build
npm run build

# Start the server
npm start

Changes from Upstream

• Added environment variable support for Neo4j connection details

• Improved error handling and connection management

• Added detailed logging for debugging

• Updated configuration to support remote Neo4j instances

License

MIT