descriptron-mcp

# descriptron-mcp **The Descriptron programs as tools for Claude and any other MCP client.** [MCP](https://modelcontextprotocol.io) (Model Context Protocol) is an open standard that lets an AI assistant call software directly. With this server installed, you can ask Claude Desktop or Claude Code things like *"summarise this COCO file, run the pipeline on it, and build the key"*, or *"write the treatment for acok from the matrix and audit it"*, and it runs the same Descriptron programs you would run from a shell. The server runs **on your own computer** and reads **your own files**. Nothing is uploaded anywhere except what the assistant itself reads through the tools. ## Install Python ≥ 3.10 is needed for the server itself. The programs can run in a different environment. See *Configuration* below. **Now.** Install the analysis package from PyPI, then the server from GitHub (until the server is on PyPI too): ```bash python -m venv descriptron-mcp-env source descriptron-mcp-env/bin/activate # Windows: descriptron-mcp-env\Scripts\activate pip install descriptron-core pip install "git+https://github.com/alexrvandam/Descriptron#subdirectory=packages/descriptron-mcp" descriptron-mcp --check # shows what it found ``` For the GPU programs (detectors, SAM2-PAL, DINOLand) also `pip install descriptron-vision`. **Later (from PyPI):** ```bash pip install descriptron-mcp # analysis programs (CPU) pip install "descriptron-mcp[vision]" # + detectors, SAM2-PAL, DINOLand (GPU) ``` **With Docker instead** (no Python setup; includes the GPU programs): ```bash claude mcp add descriptron -- docker run -i --rm --gpus all \ --user "$(id -u):$(id -g)" -v "$HOME:$HOME" \ ghcr.io/alexrvandam/descriptron:2.0.3 mcp ``` Without an NVIDIA GPU (e.g. on a Mac), leave out `--gpus all`: Docker refuses to start with it, and everything except the GPU programs works the same. `-v "$HOME:$HOME"` makes your files appear inside the container a…