Build

Cookbook

Worked examples, one experiment per page, every step written out: what you type, what you say to the agent, what the agent does, and what you see. Each example runs on simulated instruments, so you can follow it exactly on your laptop with nothing plugged in, then swap in your real instrument at the end.

Before any example

Do this once. It takes about two minutes.

  1. Install OpenMHP into your agent

    npx openmhp-cli setup

    You will see it create ~/.openmhp, install the runtime, copy the skills, and register the MCP server with Claude Code and Codex. For any other harness it prints a JSON snippet to paste into that harness's MCP settings.

  2. Add the two simulated instruments

    npx openmhp-cli demo

    You will see added thermocycler-01 and added arm-01. These behave like a real thermocycler and plate arm, sped up.

  3. Open your agent and check it sees the lab

    What instruments do I have?

    The agent should answer with the two devices, their locations (bay 3) and what each can do. If it says the lab is empty, restart the agent so it reconnects to the MCP server.

Examples

1. Run a PCR with a plate transferTwo instruments, one sentence. Shows plan mode and a confirmation step. 2. Monitor an instrument overnightA background run, alerts, and reading the results the next morning. 3. Calibrate with a setpoint sweepStep a setting through values and get a table and a CSV. 4. Reflux on a stirrer hotplateAdd an instrument from the registry, read its safety card, run a timed hold.

New examples are added regularly. Want one for your workflow? Open an issue with the instruments and the procedure.