dishmath

dishmath

完全在本机运行的餐厅算术：一道菜的制作成本、售价、食谱在不同份数之间如何调整，以及有过敏症的顾客必须避开哪些菜品。无需账号、密钥或网络请求——所有结果都根据你提供的数字在本地计算。

四种计算

• 食品成本——逐项累加一道菜的食材成本。除了单份成本，你还可以查询达到目标食品成本百分比时的售价，以及按今天的售价计算出的实际百分比。
• 菜单定价——输入单份成本和目标食品成本百分比。结果包括未税价格、加上 VAT 后的价格、向上取整到合适步长（0.50、1.00……）后的价格、扣除税费后的单份毛利，以及取整后的价格实际对应的食品成本百分比。
• 食谱缩放——输入适用于指定份数的食谱，即可获得调整为另一份数后的所有用量。如果食材包含单位成本，还会同时给出整批成本和单份成本。
• 过敏原矩阵——声明每道菜包含的过敏原，即可获得欧盟法规 1169/2011（附件 II）规定的菜品与过敏原对照表，以及按 14 种过敏原列出的需避开菜品清单。过敏原名称支持英文或意大利文，也支持常见称呼：“shrimp”会被识别为甲壳类，“dairy”会被识别为牛奶。工具不会根据菜名推测过敏原——未声明过敏原的菜品会明确标示为未声明。

金额采用四舍五入，精确到两位小数；百分比精确到一位小数。可选的 ISO 货币代码（默认为 EUR）只会影响金额的显示方式。

示例：单份成本为 €3.20，目标食品成本为 30%，VAT 为 10%，取整步长为 0.50：

Net price (before tax): €10.67
Price incl. 10% tax: €11.74
Menu price (rounded up to 0.5): €12.00
Gross profit per plate (net of tax): €7.71
Real food cost after rounding: 29.3%

CLI

npx @reneturcios/dishmath menu_price_calculator '{"plate_cost":3.20,"target_food_cost_percent":30,"vat_percent":10,"rounding_step":0.50}'
npx @reneturcios/dishmath food_cost_calculator '{"ingredients":[{"name":"flour","quantity":0.5,"unit":"kg","unit_cost":1.20}],"target_food_cost_percent":30}'
npx @reneturcios/dishmath recipe_scaler '{"ingredients":[{"name":"flour","quantity":500,"unit":"g"}],"original_portions":4,"target_portions":6}'
npx @reneturcios/dishmath allergen_matrix '{"dishes":[{"name":"Shrimp pasta","allergens":["shrimp","gluten"]}]}'
npx @reneturcios/dishmath --version

每个工具子命令都接受一个 JSON 参数字符串，并以纯文本形式输出结果。退出代码：成功时为 0；计算或验证错误时为 1；用法错误时为 2。

MCP

npx -y @reneturcios/dishmath mcp

MCP 客户端配置：

{
  "mcpServers": {
    "dishmath": {
      "command": "npx",
      "args": ["-y", "@reneturcios/dishmath", "mcp"]
    }
  }
}

通过 MCP 提供的工具：food_cost_calculator、menu_price_calculator、recipe_scaler、allergen_matrix。

Docker

docker run -i ghcr.io/cloudcorprecords/dishmath
docker run --rm ghcr.io/cloudcorprecords/dishmath menu_price_calculator '{"plate_cost":3.20,"target_food_cost_percent":30,"vat_percent":10,"rounding_step":0.50}'

容器的默认命令为 mcp，因此第一种形式会启动 stdio MCP 服务；其他参数则会传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

许可证

MIT——详见 LICENSE。