Skip to main content
Glama
README.md
# geo-evidence-mcp

An MCP server and agent for Earth-observation questions where **every numeric answer ships with
machine-checkable provenance**: STAC item, collection, band, CRS, acquisition time, processing level
and a replayable tool-call trace.

Status: **M0 scaffold**. Nothing below the status table is implemented yet.

| Milestone | Scope | State |
|---|---|---|
| M0 | Scaffold, compose, CI skeleton, ADR-001 | in progress |
| M1 | Data layer (`search_stac`, `load_window`, `zonal_stats`) | pending |
| M2 | FastMCP server | pending |
| M3 | Provenance schema + persistence + claim validator | pending |
| M4 | LangGraph agent + Langfuse tracing | pending |
| M5 | Refusal / low-confidence logic | pending |
| M6 | Benchmark + eval runner | pending |
| M7 | Naive vs provenance comparison | pending |
| M8 | Polish, demo, v0.1.0 | pending |

## Quickstart (M0)

```bash
make install        # uv sync
make init           # creates .env with generated secrets
make check          # ruff, mypy --strict, pytest
make up             # PostGIS + pgvector
make up-obs         # + self-hosted Langfuse (http://localhost:3000)
```

Benchmark results: **PENDING** (no real run exists yet).

License: MIT.