What is Neo4j Mcpserver

neo4j-mcpserver is an implementation of a Neo4j MCP server designed to manage graph database operations using the Model Context Protocol.

Use cases

Use cases include executing complex queries against a Neo4j database, integrating graph databases into applications, and managing data relationships in projects.

How to use

To use neo4j-mcpserver, you can run it directly with npx by providing your Neo4j connection details either as a single connection string or through separate environment variables. You can also install it globally using npm.

Key features

Key features include compatibility with Cursor and Claude Desktop, the ability to execute Cypher queries, and easy configuration through environment variables or a .env file.

Where to use

neo4j-mcpserver can be used in various fields that require graph database management, such as data analysis, software development, and application integration.

Neo4j MCP Server

A Neo4j MCP server implementation for managing graph database operations through the Model Context Protocol.

🔌 Compatible with both Cursor and Claude Desktop!

Quick Start

You can run the server directly using npx:

# Using a single connection string
NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password npx neo4j-mcpserver

# Or using separate environment variables
NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io NEO4J_USER=neo4j NEO4J_PASSWORD=your-password npx neo4j-mcpserver

Installation

If you prefer to install the package globally:

npm install -g neo4j-mcpserver

Then run it:

NEO4J_CONNECTION=neo4j+s://your-instance.databases.neo4j.io,neo4j,your-password neo4j-mcpserver

Environment Variables

You can provide the Neo4j connection details in two ways:

1. Using a single connection string:

   NEO4J_CONNECTION=<uri>,<user>,<password>
   

2. Using separate environment variables:

   NEO4J_URI=<your-uri>
   NEO4J_USER=<your-user>
   NEO4J_PASSWORD=<your-password>
   

You can also use a .env file in your project root:

NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
NEO4J_USER=neo4j
NEO4J_PASSWORD=your-password

Configuration ⚙️

Configuring Cursor 🖥️

To set up the Neo4j MCP server in Cursor:

1. Open Cursor Settings
2. Navigate to Features > MCP Servers
3. Click on the “+ Add New MCP Server” button
4. Fill out the following information:
   • Name: Enter a nickname for the server (e.g., “neo4j-mcp”)
   • Type: Select “command” as the type
   • Command: Enter the command to run the server:

   env=NEO4J_URI=your-neo4j-uri,NEO4J_USER=your-neo4j-user,NEO4J_PASSWORD=your-neo4j-password npx -y @neobarrientos/neo4j_mcpserver
   

   Important: Replace the credentials with your actual Neo4j database credentials.

Available Tools 🛠️

neo4j-query

Execute Cypher queries against your Neo4j database.

Example usage in Cursor:

MATCH (n) RETURN n LIMIT 5

Troubleshooting 🔧

If you encounter issues:

1. Verify Neo4j Credentials

   • Check that your Neo4j URI, username, and password are correct
   • Ensure your Neo4j database is accessible

2. Path Issues

   • Ensure there are no spaces in the installation path
   • Use forward slashes (/) in paths

3. Tool Detection Issues

   • Try restarting Cursor
   • Verify the server is running (check Cursor’s MCP server list)
   • Check that environment variables are properly set

Development 👩‍💻

To run locally:

git clone <repository-url>
cd neo4j-mcpserver
npm install
npm run build
npm start

License

ISC