MCP 服务器

property-inventory

Provides a local-first, evidence-backed ledger for physical property, enabling agents to search inventory, prepare capture reviews, and inspect proposals through MCP. Enforces strict boundaries: scoped reads by default, with private write access limited to preparing, not applying, mutations.

README

agent-property-inventory

agent-property-inventory is a local JSONL ledger that lets agents answer what you own, where it is, and what it works with.

A real inventory query finds one physically checked item, then the complete verifier passes with zero failures

Agents query before buying or advising. Facts enter through one verified local writer.

What it knows

Identity, possession, and compatibility remain unknown until their specific evidence is recorded

The ledger preserves photos, receipts, serials, locations, condition, measurements, lifecycle history, and unknowns. An empty search means “not recorded,” never “does not exist.”

How it works

Agents may read and prepare freely, while only one locked and fully verified path can replace canonical JSONL

Data/store/*.jsonl is the sole source of truth. Immutable media, runtime databases, and backups stay outside Obsidian. SQLite and Inventory.md are disposable rebuilt views.

Quick start

Python 3.11 or newer is required.

git clone https://github.com/Anneo22/agent-property-inventory.git
cd agent-property-inventory
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[dev,mcp]'

demo_root="$(mktemp -d "${TMPDIR:-/tmp}/property-inventory-demo.XXXXXX")"
export PROPERTY_INVENTORY_ROOT="$demo_root/inventory"
export PROPERTY_INVENTORY_RUNTIME="$demo_root/runtime"
export PROPERTY_INVENTORY_MEDIA_ROOT="$demo_root/media"
export PROPERTY_INVENTORY_CATALOGUE_OUTPUT="$demo_root/notes/Inventory.md"

property-inventory init
property-inventory status

status rebuilds SQLite, regenerates the catalogue, runs the semantic verifier, and checks every foreign key.

Use it

Query before buying or claiming ownership:

property-inventory search "hex bit" --condition working
property-inventory context --task "repair a bicycle tyre"
property-inventory compatibility itm-driver itm-bit
property-inventory torque-check --tool-item-id itm-driver --requested-nm 4

Record a real check against an existing item and location:

property-inventory physical-check \
  --actor "Example reviewer" \
  --source-ref "Checked in person" \
  --item-id itm-example \
  --checked-on 2026-08-09 \
  --location-id loc-example \
  --quantity 1 \
  --condition working

The CLI also records plans, orders, deliveries, moves, loans, sales, corrections, evidence, kits, maintenance, insurance readiness, measured spaces, and offline replica proposals. Run property-inventory --help for the complete command surface.

Connect an agent

The MCP server is a local stdio process. Its default read profile can search, inspect, and reason about the inventory without changing canonical JSONL.

{
  "command": "/absolute/path/to/property-inventory-mcp",
  "args": [
    "--config", "/absolute/path/to/config.json",
    "--instance", "private",
    "--scope", "personal",
    "--profile", "read"
  ]
}

The private write profile may prepare bounded proposals, capture reviews, and replica plans. It cannot apply them or invoke direct lifecycle mutations. See MCP profiles.

Deliberate limits

There is no web or phone interface, hosted sync service, bundled recognition model, insurer integration, or proof of broad real-world adoption. Spatial packing is a deterministic measured-box heuristic, not an optimal organizer. Local capture adapters are trusted programs and still require explicit review.

Documentation

Development

ruff check .
python3 -m compileall -q src property_inventory.py rebuild_inventory_sqlite.py render_inventory.py verify_inventory.py
python3 -m unittest discover -v -s tests -p 'test_*.py'
vhs docs/assets/demo.tape
python3 scripts/check-readme-visuals.py
scripts/check-public-leaks.sh