hugegraph-data-importer

# HugeGraph Data Importer ## Tool Routes | Goal | Tool | | --- | --- | | Inspect schema, primary keys, or edge endpoints | `inspect_graph_tool(include_raw_schema=true)` | | Extract candidate graph data from text | `extract_graph_data_tool(text, graph_schema?, example_prompt?)` | | Preview structured vertex/edge import | `import_graph_data_tool(mode="ingest", graph_data, dry_run=true)` | | Execute confirmed import | Unavailable: preview-only, no `plan_id`; confirmation returns `FEATURE_DISABLED` | | Preview controlled vertex/edge delete | `delete_graph_data_tool(change_plan, dry_run=true)` | | Execute confirmed controlled delete | `confirm_write_tool(plan_id)` for a confirmable exact edge delete only | | Verify imported data | `query_graph_data_tool` (bounded page or exact ID query) | `change_plan` must contain exact operations. For example, a vertex delete preview (not executable) is: ```json {"operations":[{"op":"delete_vertex","label":"person","match":{"name":"Alice"}}]} ``` Edge deletion uses `op: "delete_edge"`, `label`, `source_label`, `source_match`, `target_label`, and `target_match`. Each operation must resolve to exactly one target during dry-run; bulk and cascade deletes are not supported. ## Order ```text inspect_graph_tool -> extract_graph_data_tool or prepare graph_data -> import_graph_data_tool(dry_run=true) -> review preview (stop: no executable import plan) ``` For controlled deletes: ```text inspect_graph_tool(include_raw_schema=true) -> delete_graph_data_tool(dry_run=true) -> confirm_write_tool(plan_id), only for confirmable exact edge deletes -> get_write_status_tool(plan_id) -> query_graph_data_tool ``` Structured query and plan lifecycle tools require the default `core` toolset. For a `legacy` deployment, enable `HUGEGRAPH_MCP_TOOLSET=core` and restart before using them. These skills describe the current release with `core` / `legacy`. The previous `1.7.1` release uses `v2_core` / `v1`; see the [migration guide](../../hugegraph-mcp/README.md#toolset-naming-and-migration).