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
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 graphcreate_relations- Create relations between entities (in active voice)add_observations- Add new observations to existing entitiesdelete_entities- Delete entities and their relationsdelete_observations- Delete specific observations from entitiesdelete_relations- Delete specific relationsread_graph- Read the entire knowledge graphsearch_nodes- Search for nodes based on a queryopen_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