Metadata-Version: 2.4
Name: kuzu-mcp
Version: 0.1.0
Summary: Standalone Scientifiq-style MCP provider for per-tier Kuzu graph CRUD
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: kuzu-grid-schema<1,>=0.1
Requires-Dist: mcp<2,>=1.27
Requires-Dist: pydantic>=2.0
Requires-Dist: jsonschema>=4.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"

# kuzu-mcp

Standalone MCP provider for **per-tier Kuzu graph CRUD** on a **single shared database**.

Depends on [`kuzu-grid-schema`](../kuzu_grid_schema) via pip (owns DDL, tier contracts, and Cypher).
Does **not** import the parent `pandapower-grid-mcp` / `grid_sim` packages.

## Install

```bash
pip install -e ../kuzu_grid_schema
pip install -e .
```

## Run

```bash
kuzu-mcp --transport streamable-http --port 8213
```

Tool names are unprefixed (e.g. `tier0_bus_create`); the gateway applies a namespace such as `kuzu.`.

## Domains

| Domain | Tools |
|--------|--------|
| `tier0` | bus / branch / generator / load / boundary_injection CRUD |
| `tier1` | overlay apply / get / clear |
| `tier2` | grid_config, scenario, scope, effective |
| `tier3` | simulation_run, sim_result_bus, sim_result_branch |

All tools accept `db` (`:memory:` or one on-disk path).
