Metadata-Version: 2.4
Name: neo4j-mcp
Version: 0.1.1
Summary: MCP server for Neo4j graph database operations
Project-URL: Homepage, https://github.com/lesleslie/neo4j-mcp
Project-URL: Repository, https://github.com/lesleslie/neo4j-mcp.git
Author-email: Les Leslie <les@wedgwood.us>
License: BSD-3-Clause
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.13
Requires-Dist: fastmcp>=2.12.3
Requires-Dist: mcp-common>=0.4.8
Requires-Dist: neo4j>=5.0.0
Requires-Dist: oneiric>=0.3.6
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.10.0
Requires-Dist: rich>=13.0.0
Requires-Dist: structlog>=25.0.0
Requires-Dist: typer>=0.15.0
Requires-Dist: uvicorn>=0.30.0
Description-Content-Type: text/markdown

# neo4j-mcp

MCP server for Neo4j graph database operations.

## Installation

```bash
uv pip install -e .
```

## Usage

```bash
# Stdio mode (default)
neo4j-mcp serve

# HTTP mode
neo4j-mcp serve --http --port 3045

# With mock mode for testing
neo4j-mcp serve --mock

# With custom connection
neo4j-mcp serve --uri bolt://localhost:7687 --database neo4j
```

## Tools

**Queries:**
- `run_cypher` - Execute Cypher queries

**Nodes:**
- `create_node` - Create a node
- `get_node` - Get node by ID
- `delete_node` - Delete a node
- `find_nodes` - Find nodes by criteria

**Relationships:**
- `create_relationship` - Create relationship
- `delete_relationship` - Delete relationship

**Paths:**
- `find_paths` - Find paths between nodes

**Schema:**
- `get_schema` - Get database schema info

## Configuration

Set via environment variables with `NEO4J_MCP_` prefix:
- `NEO4J_MCP_URI` - Neo4j URI (default: bolt://localhost:7687)
- `NEO4J_MCP_USER` - Username (default: neo4j)
- `NEO4J_MCP_PASSWORD` - Password
- `NEO4J_MCP_DATABASE` - Database name (default: neo4j)
- `NEO4J_MCP_MOCK_MODE` - Enable mock mode
