Da Okazaki MCP Neo4j Server

🚀 MCP Command Line Tool for Neo4j Server

A MCP server that provides integration between the Neo4j graph database and Claude Desktop, enabling graph database operations through natural language interaction.

🚀 Quick Start

You can directly run this MCP server using npx:

npx @alanse/mcp-neo4j

Or add it to the Claude Desktop configuration:

{
  "mcpServers": {
    "neo4j": {
      "command": "npx",
      "args": ["@alanse/mcp-neo4j-server"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USERNAME": "neo4j",
        "NEO4J_PASSWORD": "Your password"
      }
    }
  }
}

✨ Features

This server provides tools for interacting with the Neo4j database:

Tools

• execute_query: Execute Cypher queries on the Neo4j database

  • Supports all types of Cypher queries (read, create, update, delete)
  • Returns structured query results
  • Allows passing parameters to prevent injection attacks

• create_node: Create a new node in the graph database

  • Define node labels and properties
  • Supports nested object properties

• create_relationship: Establish a relationship between existing nodes

  • Specify the start and end nodes and the relationship type
  • Allows adding relationship properties

📦 Installation

Install via Smithery:

npm install -g @alanse/mcp-neo4j-server

Manual installation:

git clone git://github.com/your-account/mcp-neo4j.git
cd mcp-neo4j
npm install

📚 Documentation

Configuration

Set the following environment variables:

export NEO4J_URI=bolt://localhost:7687
export NEO4J_USERNAME=neo4j
export NEO4J_PASSWORD=Your password

💻 Usage Examples

Basic Usage

Query example:

mcp neo4j execute_query --query "MATCH (n) RETURN count(n)"

Advanced Usage

Create a node:

mcp neo4j create_node --labels Person --props '{"name": "Alice", "age": 30}'

Establish a relationship:

mcp neo4j create_relationship --start-id node1_id --end-id node2_id --type KNOWS --props '{"since": "2024"}'

🔧 Technical Details

Testing

Run the test suite:

npm test

📄 License

MIT