Generate Python client library from Neo4j schema via MCP server

[Copilot]

Auto-generated a production-ready Python client library by introspecting the Neo4j aviation database schema through the MCP server.

Generated Package (neo4j_client/)

• 9 Pydantic models - Type-safe data classes for all schema entities (Aircraft, Flight, MaintenanceEvent, System, Component, Sensor, Reading, Airport, Delay)
• 3 repository classes - CRUD operations with specialized queries (find_by_aircraft, find_by_severity)
• Connection manager - Context manager with session lifecycle management
• Custom exceptions - Structured error hierarchy (ConnectionError, QueryError, NotFoundError)

Security & Quality

• Parameterized Cypher queries throughout (no string interpolation)
• MERGE-based operations to prevent duplicate nodes
• Type hints on all functions/methods
• Pydantic validation for all inputs

Testing

• 13 integration tests using testcontainers
• Full CRUD coverage for all repositories
• Edge case handling (not found, duplicates, errors)

Usage

from neo4j_client import Neo4jConnection, AircraftRepository, Aircraft

with Neo4jConnection(uri, username, password) as conn:
    with conn.get_session() as session:
        repo = AircraftRepository(session)
        
        aircraft = Aircraft(
            aircraft_id="AC001",
            tail_number="N12345",
            model="Boeing 737-800",
            operator="Example Airlines",
            manufacturer="Boeing",
            icao24="ABC123"
        )
        repo.create(aircraft)
        
        found = repo.find_by_id("AC001")

Package Structure

neo4j_client/
├── models.py           # 9 Pydantic models
├── repository.py       # 3 repository implementations
├── connection.py       # Connection management
├── exceptions.py       # Custom exceptions
└── README.md          # API documentation

tests/
├── conftest.py        # Testcontainers fixtures
└── test_repository.py # 13 integration tests

Provides foundation for extending with additional repositories (Airport, System, etc.), relationship management, and advanced query patterns.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• 0.0.0.0.in-addr.arpa
  • Triggering command: /opt/java/openjdk/bin/java -cp /var/lib/neo4j/plugins/*:/var/lib/neo4j/conf/*:/var/lib/neo4j/lib/* -XX:+UseG1GC -XX:-OmitStackTraceInFastThrow -XX:+AlwaysPreTouch -XX:+UnlockExperimentalVMOptions -XX:+TrustFinalNonStaticFields -XX:+DisableExplicitGC -Djdk.nio.maxCachedBufferSize=1024 -Dio.netty.tryReflectionSetAccessible=true -Djdk.tls.ephemeralDHKeySize=2048 -Djdk.tls.rejectClientInitiatedRenegotiation=true -XX:FlightRecorderOptions=stackdepth=256 -XX:+UnlockDiagnosticVMOptions -XX:+DebugNonSafepoints --add-opens=java.base/java.nio=ALL-UNNAMED --add-opens=java.base/java.io=ALL-UNNAMED --add-opens=java.base/sun.nio.ch=ALL-UNNAMED -Dlog4j2.disable.jmx=true -Dfile.encoding=UTF-8 org.neo4j.server.CommunityEntryPoint --home-dir=/var/lib/neo4j --config-dir=/var/lib/neo4j/conf --console-mode (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Create a starting neo4j python client from the neo4j schema

Custom agent used: neo4j-docker-client-generator
AI agent that generates simple, high-quality Python Neo4j client libraries from GitHub issues with proper best practices

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.