Neo4j MCP Server 🚀

A Neo4j MCP server implementation for managing graph database operations.

🔌 Compatible with both Cursor and Claude Desktop!

Prerequisites 🔧

Before you begin, ensure you have:

• Neo4j database credentials
• Node.js (v16 or higher)
• Cursor IDE (v0.45.6 or higher) or Claude Desktop

Installation ⚡

npx @neobarrientos/neo4j_mcpserver

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.

Using Environment Variables 🔑

If you prefer not to include credentials in the command, you can use a .env file:

1. Create a .env file in your project root:

NEO4J_URI=your-neo4j-uri
NEO4J_USER=your-neo4j-user
NEO4J_PASSWORD=your-neo4j-password

2. Then use this command in Cursor:

npx @neobarrientos/neo4j_mcpserver

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