RoastPilot
Control a home coffee roaster and log roasts through local MCP tools
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"coffee-roaster-mcp": {
"command": "uvx",
"args": [
"coffee-roaster-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"coffee-roaster-mcp": {
"command": "uvx",
"args": [
"coffee-roaster-mcp"
]
}
}
}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.
