MCP for Neo4j

Se conecta a bases de datos de grafos Neo4j con capacidad de usar funciones GDS (cuando estén disponibles), un modo de solo lectura y establecer el tamaño de muestra para la detección del esquema.

GitHub
297
Prueba este MCPPatrocinado

Documentación

Neo4j MCP

Neo4j MCP brinda a los asistentes de IA y herramientas impulsadas por LLM acceso directo y estructurado a tu base de datos de grafos Neo4j. Al implementar el Protocolo de Contexto de Modelo (MCP), actúa como un puente entre cualquier cliente compatible con MCP, como Claude, Cursor o VS Code con soporte MCP, y tu instancia de Neo4j.

Características

  • Explora el esquema de tu grafo: descubre etiquetas de nodos, tipos de relaciones y claves de propiedades
  • Permite que la IA razone sobre tu modelo de datos sin conocimiento previo
  • Ejecuta consultas Cypher: ejecuta, lee y escribe consultas contra tu base de datos en respuesta a indicaciones en lenguaje natural
  • Inspecciona y analiza datos: recupera nodos, relaciones y rutas para responder preguntas, generar resúmenes o alimentar otros flujos de trabajo

Herramientas

  • get-schema — inspecciona etiquetas, tipos de relaciones, claves de propiedades
  • read-cypher — ejecuta consultas Cypher de solo lectura que no modifican los datos de la base de datos, aplicado mediante EXPLAIN y la clasificación de tipo de consulta de Neo4j. Nota: los procedimientos o funciones personalizados clasificados incorrectamente como de solo lectura por Neo4j pueden omitir esta verificación; garantizar una clasificación correcta es responsabilidad del mantenedor del procedimiento/función.
  • write-cypher — ejecuta consultas Cypher de escritura (deshabilitado si NEO4J_MCP_READ_ONLY=true)
  • list-gds-procedures — lista los procedimientos GDS disponibles

Instalación

Instalar con PyPI:

pip install neo4j-mcp-server

De lo contrario, consulta Documentación de MCP -> Instalación.

Configuración del servidor (VSCode)

Crea / edita mcp.json:

{
  "servers": {
    "neo4j": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "neo4j_mcp_server"],
      "env": {
        "NEO4J_MCP_URI": "bolt://localhost:7687",
        "NEO4J_MCP_USERNAME": "neo4j",
        "NEO4J_MCP_PASSWORD": "password",
        "NEO4J_MCP_DATABASE": "neo4j",
        "NEO4J_MCP_READ_ONLY": "true",
        "NEO4J_MCP_TELEMETRY": "false",
        "NEO4J_MCP_LOG_LEVEL": "info",
        "NEO4J_MCP_LOG_FORMAT": "text",
        "NEO4J_MCP_SCHEMA_SAMPLE_SIZE": "100"
      }
    }
  }
}

Consulta Documentación de MCP > Configuración para más detalles.

Enlaces

Para problemas y comentarios, también puedes crear un issue en GitHub con detalles de reproducción (omite datos sensibles).