Servidor MCP Neo4j

Una implementación de servidor MCP de Neo4j para administrar operaciones de bases de datos gráficas a través del Protocolo de Contexto de Modelo.

🔌 ¡Compatible con Cursor y Claude Desktop!

Inicio rápido

Puedes ejecutar el servidor directamente usando 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

Related MCP server: M.I.M.I.R - Multi-agent Intelligent Memory & Insight Repository

Instalación

Si prefiere instalar el paquete globalmente:

npm install -g neo4j-mcpserver

Luego ejecútalo:

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

Variables de entorno

Puede proporcionar los detalles de conexión de Neo4j de dos maneras:

1. Usando una sola cadena de conexión:

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

2. Usando variables de entorno separadas:

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

También puedes utilizar un archivo .env en la raíz de tu proyecto:

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

Configuración ⚙️

Configurando el cursor 🖥️

Para configurar el servidor MCP de Neo4j en Cursor:

1. Abrir configuración del cursor

2. Vaya a Características > Servidores MCP

3. Haga clic en el botón "+ Agregar nuevo servidor MCP"

4. Complete la siguiente información:

   • Nombre: Ingrese un apodo para el servidor (por ejemplo, "neo4j-mcp")

   • Tipo: Seleccione "comando" como tipo

   • Comando: Ingrese el comando para ejecutar el servidor: GXP7

   Importante: reemplace las credenciales con sus credenciales de base de datos Neo4j reales.

Herramientas disponibles 🛠️

consulta neo4j

Ejecute consultas Cypher en su base de datos Neo4j.

Ejemplo de uso en Cursor:

MATCH (n) RETURN n LIMIT 5

Solución de problemas 🔧

Si encuentra problemas:

1. Verificar credenciales de Neo4j

   • Comprueba que tu URI, nombre de usuario y contraseña de Neo4j sean correctos

   • Asegúrese de que su base de datos Neo4j sea accesible

2. Problemas de ruta

   • Asegúrese de que no haya espacios en la ruta de instalación

   • Utilice barras diagonales (/) en las rutas

3. Problemas de detección de herramientas

   • Intente reiniciar el cursor

   • Verifique que el servidor esté ejecutándose (verifique la lista de servidores MCP de Cursor)

   • Compruebe que las variables de entorno estén configuradas correctamente

Desarrollo 👩‍💻

Para ejecutar localmente:

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

Licencia

ISC