mirror of
https://github.com/luxfi/mcp.git
synced 2026-09-24 00:25:04 +00:00
The missing "LLM of node operator" half of on-chain AI governance: a read-only MCP server a node exposes so an operator-LLM can query its own chain mid-thought before signing an AIGovernor verdict — chain_state, param_history, receipt_lookup, quorum_status, etc. Read-only by construction (AST gate, no state-mutating verb), bounded calls + per-call timeout, every read at a pinned block. EthCaller is the read-only EVM seam; quorum tally mirrors AIGovernor.settle so the LLM sees the same canonical view the chain will. cmd/aivm-gov-mcp serves it over stdio (drop-in for hanzo-dev / Claude Desktop mcp-servers, like gym.distributed.mcp). Verified: go test ./governance/ = ok (SDKROOT set; CGO secp256k1/gopsutil need the macOS SDK path). Pairs with luxfi/standard ai/governance (AIGovernor/AIApproval/ AIExecute). Future: decomplect transport+evmread to module root as a Surface once a 2nd surface (mining/treasury) lands — held per YAGNI.