# RoastPilot

> RoastPilot is an open-source MCP server for food and drink. Control a home coffee roaster and log roasts through local MCP tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/syamaner/coffee-roaster-mcp
- **MCP Registry name:** io.github.syamaner/coffee-roaster-mcp
- **Categories:** [food and drink](https://ai-powered.com/categories/food-and-drink)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add coffee-roaster-mcp -- uvx coffee-roaster-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_roast_state`: Reports the current roast state

## 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.

## Alternatives

- [Openfoodfacts](https://ai-powered.com/mcp/openfoodfacts): Openfoodfacts is a freemium MCP server for food and drink.
- [Menus Recommender](https://ai-powered.com/mcp/menus-recommender): Menus Recommender is an open-source MCP server for food and drink.
- [Spoonacular](https://ai-powered.com/mcp/spoonacular): Spoonacular is a freemium MCP server for food and drink.
- [Foodish](https://ai-powered.com/mcp/foodish): Foodish is a freemium MCP server for food and drink.
- [Achiote](https://ai-powered.com/mcp/achiote): Achiote is an open-source MCP server for food and drink.
- [Bloody Mary Bar & Grill](https://ai-powered.com/mcp/bloody-mary-bar-and-grill): Bloody Mary Bar & Grill is an MCP server for food and drink.
- [Tablespoons to milliliters](https://ai-powered.com/mcp/tablespoons-to-milliliters): Tablespoons to milliliters is an MCP server for food and drink.
- [Fast Food Index](https://ai-powered.com/mcp/fast-food-index): Fast Food Index is a free MCP server for food and drink.

---
Source: https://ai-powered.com/mcp/roastpilot
