Skip to content
MCP server

RoastPilot

Control a home coffee roaster and log roasts through local MCP tools

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.4
Listing updated
today

Similar MCP servers

About RoastPilot

RoastPilot is an open-source MCP server for food and drink. It runs locally on your machine and is started by your AI client.

RoastPilot gives an AI agent supervised control of a coffee roaster. The README describes live tests on a Hottop KN-8828B-2K+, where an agent drove heat, fan, drop and cooling, detected the start of the roast automatically from the bean-temperature drop and heard first crack through a USB microphone using an INT8 ONNX model.

One local stdio server owns roaster control, session timing and events, first-crack detection, derived roast metrics and log export (roast.jsonl, roast.csv and summary.json). A safety evaluation layer sits between advisor decisions and actuation, and the author reports a guarded validation run that exercised drop and emergency stop.

The package is coffee-roaster-mcp on PyPI and in the MCP Registry, installed through uvx. The README is careful to say that its evidence does not prove calibration, accuracy or safety in general, and that it does not authorise any hardware use by itself.

Install

Run in a terminal

claude mcp add coffee-roaster-mcp -- uvx coffee-roaster-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "coffee-roaster-mcp": {
      "command": "uvx",
      "args": [
        "coffee-roaster-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "coffee-roaster-mcp": {
      "command": "uvx",
      "args": [
        "coffee-roaster-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "coffee-roaster-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "coffee-roaster-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "coffee-roaster-mcp": {
      "command": "uvx",
      "args": [
        "coffee-roaster-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "coffee-roaster-mcp": {
      "command": "uvx",
      "args": [
        "coffee-roaster-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

get_roast_state
Reports the current roast state

What it does

Roaster control
Drives heat, fan, drop and cooling on supported hardware.
Automatic start detection
Detects beans being added from the bean-temperature drop.
First-crack detection
Listens through a microphone and confirms first crack with a sliding-window model.
Safety evaluation
Checks agent decisions before they actuate the roaster.
Roast metrics
Derives metrics from session telemetry and events.
Log export
Writes JSONL, CSV and summary files for each roast.

Good for

  • Let an agent assist or run a supervised home roast
  • Record temperature and event data for every batch
  • Detect first crack automatically instead of by ear
  • Review exported roast logs afterwards

Pricing

Open source

Free open-source package on PyPI

RoastPilot FAQ

Which roaster has it been tested with?

The README documents roasts on a Hottop KN-8828B-2K+.

How do I install it?

From PyPI as coffee-roaster-mcp, for example via uvx.

What does it export?

roast.jsonl, roast.csv and summary.json.

Is it safe to leave unattended?

The README describes supervised roasts and disclaims claims of general safety or readiness.

Is RoastPilot free?

Yes. RoastPilot is open source, so you can use and self-host it for free.

How do I add RoastPilot to Claude Code?

Run this command in your terminal: claude mcp add coffee-roaster-mcp -- uvx coffee-roaster-mcp

What are the best alternatives to RoastPilot?

The closest alternatives to RoastPilot are Openfoodfacts, Menus Recommender, Spoonacular, Foodish and Achiote.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers