Neo4j Graph

# 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](https://modelcontextprotocol.io/introduction)

## 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:
```bash
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

```bash
# 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