Neo4j Server

neo4j-server-remote

neo4j-server-remote es un servidor MCP que utiliza Server-Sent Events (SSE) o STDIO como protocolo de transporte.

Resumen

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona interacción con bases de datos y permite capacidades de exploración de grafos a través de Neo4j. Este servidor permite la ejecución de consultas de grafos Cypher, el análisis de datos de dominio complejos y admite la selección de bases de datos accesibles de forma remota. Inspirado en neo4j-contrib/mcp-neo4j.

Prompts

El servidor proporciona un prompt de demostración:

• mcp-demo: Prompt interactivo que guía a los usuarios a través de operaciones de base de datos
  • Genera esquemas de base de datos apropiados y datos de muestra

Herramientas

El servidor ofrece tres herramientas principales:

Herramientas de consulta

• read-neo4j-cypher

  • Ejecutar consultas de lectura Cypher para leer datos de la base de datos
  • Entrada:
    • query (string): La consulta Cypher a ejecutar
  • Devuelve: Resultados de la consulta como un array de objetos

• write-neo4j-cypher

  • Ejecutar consultas Cypher de actualización
  • Entrada:
    • query (string): La consulta de actualización Cypher
  • Devuelve: un contador de resumen de resultados con { nodes_updated: number, relationships_created: number, ... }

Herramientas de esquema

• get-neo4j-schema
  • Obtener una lista de todos los tipos de nodos en la base de datos de grafos, sus atributos con nombre, tipo y relaciones con otros tipos de nodos
  • No se requiere entrada
  • Devuelve: Lista de etiquetas de nodos con dos diccionarios, uno para atributos y otro para relaciones

Uso con el cliente Cline

1. Clonar el repositorio

git clone https://github.com/dsimile/mcp-neo4j-server-sse.git

2. Instalar los requisitos

• Python 3.12+

cd mcp-neo4j-server-sse

pip install -r requirements.txt

3. Ejecutar el servidor

• Modo SSE (por defecto)

Ejecute el servidor MCP usando el comando UX y seleccione la base de datos de su elección. La dirección IP predeterminada es 0.0.0.0 y el puerto predeterminado es 8543.

uv run .\src\mcp-neo4j-cypher\neo4j_server_remote.py --url bolt://localhost:7687 --username neo4j --password neo4j123 --database neo4j

• Modo STDIO

Ejecute el servidor MCP localmente usando el comando UX con el modo configurado en STDIO y la misma información de conexión de Neo4j.

Nota: Asegúrese de que Neo4j esté en ejecución y sea accesible para conexiones remotas.

Paquete publicado

Agregue la configuración del servidor a su cline_mcp_settings.json.

• Modo SSE (por defecto)

{
  "mcpServers": {
    "neo4j-remote": {
      "url": "http://0.0.0.0:8543/sse",
      "disabled": false,
      "autoApprove": []
    }
  }
}

• Modo STDIO

{
  "mcpServers": {
    "neo4j-local": {
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "run",
        "/absolute/path/to/neo4j_server_remote.py",
        "--url",
        "bolt://localhost:7687",
        "--username",
        "neo4j",
        "--password",
        "neo4j123",
        "--database",
        "neo4j",
        "--mode",
        "stdio"
      ]
    }
  }
}

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.