Neo4j MCP Server

Integrations

  • Supports configuration through .env files for setting Neo4j connection details, providing a convenient way to manage database credentials.

  • Enables execution of Cypher queries against a Neo4j graph database, allowing management of graph database operations through the Model Context Protocol.

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

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

-
security - not tested
F
license - not found
-
quality - not tested

Una implementación para administrar operaciones de bases de datos de gráficos Neo4j a través del Protocolo de Contexto de Modelo, que permite a los usuarios ejecutar consultas Cypher en su base de datos Neo4j a través de asistentes de IA como Cursor y Claude Desktop.

  1. Quick Start
    1. Installation
      1. Environment Variables
        1. Configuration ⚙️
          1. Configuring Cursor 🖥️
        2. Available Tools 🛠️
          1. neo4j-query
        3. Troubleshooting 🔧
          1. Development 👩‍💻
            1. License
              ID: dnuw2xtl57