Geocluster Research Harness

A browser IDE with a geology research agent built in.

A Cline fork, a Python server with fifty-odd geology tools, and a specialist agent, all in one Docker image that runs on your own machine.

The Geocluster Research Harness browser IDE, with an assay table open beside the built-in geology agent.
The harness in use, from Meet the Geocluster Research Harness.

General coding assistants are unreliable on geological data. Give one a detection limit written “<0.005” and it reads the value as 0.005. Give it a big assay table and it loads the whole thing into context, then loses track of what is in it. Its answers are also hard to check against the file they came from. The Geocluster Research Harness is a local tool built for this: you hand the agent a dataset, and it clusters, maps, or ranks anomalies by running tools over the file itself.

It opens in a browser at localhost:3000. Behind that is a fork of Cline with limits on what the agent is allowed to do, plus geocluster-mcp, a Python server of more than fifty tools. They cover dataset inspection, raster and band math, clustering, and anomaly ranking. Every tool is restricted to the project folder. The agent calls these tools instead of writing throwaway scripts, so you can see and rerun each step. A small synthetic project is included, so you can try it without your own data.

The only thing that leaves your machine is the request to whichever model provider you set up, whether that is OpenRouter, Anthropic or OpenAI. You supply the API key. The code is Apache-2.0, and the fork is maintained separately from Cline.

How it works

Geology agent
A fork of Cline, organised in layers. A read-only interface sits on top, then an orchestrator, then specialists for analytics, data handling, plotting and transforms. Each layer reaches only a fixed set of tools, and a separate layer handles package installs.
geocluster-mcp
The Python server that holds the tools. Fifty-plus of them, and none can touch anything outside the project folder.
Docker image
Runs the whole thing locally through code-server. No sign-up, no telemetry.
Checkable results
The agent reads data as its schema, a statistical summary and sample rows rather than loading the raw table. Every result cites its source and comes with files you can open.