Neo4j MCP

🚀 Neo4j MCP Server

This is a Neo4j database operation service based on the MCP framework, which simplifies database operations and enhances efficiency.

🚀 Quick Start

The Neo4j MCP Server is a service designed for Neo4j database operations. It offers a range of features and is easy to install and use.

✨ Features

• Support for asynchronous operations.
• Provide basic operation interfaces for the Neo4j database.
• Support for proxy server configuration.
• Complete logging.

📦 Installation

pip install -e .

💻 Usage Examples

Basic Usage

1. Configuration: Create a .env file and set the following environment variables:

NEO4J_URI=http://your-neo4j-server:7474
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your-password
HTTP_PROXY=http://your-proxy:port  # Optional
HTTPS_PROXY=http://your-proxy:port  # Optional

2. Start the server:

python src/server.py

3. Use the MCP client to call the service:

from mcp.client import Client

async with Client() as client:
    # Execute a Cypher query
    result = await client.execute_query("MATCH (n) RETURN n LIMIT 5")
    
    # Create a node
    node = await client.create_node("Person", {"name": "张三", "age": 30})
    
    # Create a relationship
    rel = await client.create_relationship(1, 2, "KNOWS", {"since": "2024"})

Advanced Usage

Development Process

1. Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate  # Windows

2. Install development dependencies:

pip install -e ".[dev]"

3. Run tests:

python -m pytest

📄 License

This project is licensed under the MIT License.