plate-cost

レシピの原価計算とメニュー価格設定を行うMCPアプリ — モデルが自ら計算する代わりに開くインタラクティブな計算機です。

Claudeに「私のナシゴレンの価格設定を手伝って」と頼むと、動作するスプレッドシートが得られます。材料の行、購入価格、廃棄率、歩留まり、マージンスライダー。数字を変えると、すべてが再計算されます。これらの数字を使うを押すと、モデルは自分がでっち上げた数字ではなく、あなたが入力した数字で会話を続けます。

MCP Apps（ext-apps）上に構築されています。

ext-appsのbasic-hostリファレンスホストで実行中 — Claudeではありません。モデルがレシピを提案し、ウィジェットがそれを読み込み、「これらの数字を使う」が修正された数字を会話に送り返しました。

なぜアプリでありツールではないのか

原価計算は探索であり、質問ではありません。分量を動かしてマージンが動くのを見るまで、欲しい答えはわかりません。チャットはそのためのインターフェースとしては不向きで、モデルが頭の中で計算するのはさらに悪い — LLMは多段階の数値計算には信頼できず、確信を持っているように聞こえることには完全に信頼できます。

つまり分担はこうです：ウィジェットが入力を取得し、サーバーが計算を行い、モデルが会話をします。

Related MCP server: TradingCalc MCP Server

興味深い点：数字の出所を知る

MCP Appsには未解決のギャップがあります — ext-apps#746：ウィジェットからのtools/callとモデルが行うことを決定したものは、サーバーでは区別できません。ほとんどのツールではそれは問題になりません。原価計算ツールでは、それが計算をしているのか、推測を偽装しているのかを決定します。

mcp-app-attestがそれを解決します — このリポジトリから抽出され、最初の利用者です。サーバーはアプリリソースを提供するたびに短命のトークンを発行し、ドキュメントに置き換えます。ウィジェットは毎回の呼び出しで_metaにそれをエコーバックします。モデルはリソース本文を見ることはないので、トークンを生成できません。呼び出しはどちらにせよ応答されます — 応答はどちらが取得したかを示します：

{ "perPortion": 3300, "inputsFrom": "model" }

そして数字がモデルから来た場合、テキスト返信はその旨を述べます：

注：これらの数字は計算機ではなくモデルから来たものです。それらに依存する前に、購入価格をユーザーに確認してください。

リファレンスホストに対してエンドツーエンドで検証済みで、単体テストだけではありません：

[provenance] inputsFrom=model  reason=missing  meta=null
[provenance] inputsFrom=app    meta={..."io.platecost/app-attestation":"XfqGVAiP…"}

これは何ではないか。 認証でもなく、人間が何かを入力した証拠でもありません。コードパスを区別するものであり、アイデンティティではありません。ホストがリソーステキストをモデルコンテキストにコピーした場合、モデルはトークンを読むことができます — ここではそれを防ぐものは何もなく、それはホストが守るべき契約です。侵害されたウィジェットは好きなものを送信できます。「私のフォームに入力された」と「言語モデルによって生成された」の違いとして扱ってください。それはまさに#746が求めているものです。

その後、mcp-app-attestに抽出され、保存トークンではなく署名付きトークンに切り替わりました — その理由は下の「うまくいかなかったこと」の注を参照してください。

ドメインが間違えている2つのこと

両方ともsrc/costing.tsにあり、両方ともテストがあります。

廃棄はより多く使うのではなく、より多く買うことを意味します。 コストはused / (1 - wastePct)であり、used * (1 + wastePct)ではありません。廃棄率50%では、1.5倍ではなく2倍を買います。単純なバージョンは、あなたが所有するすべてのトリミングされた材料を過小評価します。

マージンとマークアップは異なる数字です。 マージンは(price - cost) / price、マークアップは(price - cost) / costです。60%のマークアップは37.5%のマージンであり、60%のマージンには150%のマークアップが必要です。priceForMarginはマージンを受け取ります — それはキッチンで「65%が欲しい」という意味です — そして両方を返すので、ギャップが想定ではなく見えるようになります。

また処理されるもの：質量と体積のファミリー内の単位変換、それらをまたぐ場合の拒否（kg → lには密度が必要ですが、それは与えられていません）、材料ごとのコスト配分、およびバッチごとではなくポーションごとに適用される間接費。

試す

npm install
npm run build      # bundles the widget to a single inlined HTML
npm test           # 21 tests
npm run dev        # widget standalone in a browser, no host

MCPクライアントをserver.tsに向けてください。ホストの外ではアテステーションプレースホルダーは置き換えられないため、呼び出しはmodelとラベル付けされます — それが正直な答えです。

うまくいかなかったこと

• ステートレスなHTTPトランスポート。 最初のバージョンはリクエストごとに新しいサーバーを構築しました。これはステートレスなツールには問題ありませんが、このツールを静かに壊します：アテステーションはウィジェットがコールバックした時点で存在しなくなったサーバーインスタンスによって発行されたため、すべてのウィジェット呼び出しがunknownとして拒否されました。インメモリテストではそれを見ることができませんでした — それらは1つのインスタンスを共有しています。実際のホストに対して実行したときだけ、それが明らかになりました。

• SDKのせいにすること。 上記を見つける前に、明白な容疑者は_metaが転送中に削除されることでした。そうではありません：リファレンスホストはサンドボックスプロキシを通してそれを完全に転送します。知っておく価値があります。なぜなら、メカニズム全体がホストがそうすることを依存しており、仕様はそれを要求していないからです。

ステータス

v0。2つのツール（cost-recipe、price-portion）、1つのウィジェット、21のテスト。

未構築：会話間の永続化、複数レシピの比較、および#753 / #745の名前空間問題に触れるもの — callServerToolは裸のツール名を使用するため、これはアグリゲーターの背後で壊れます。それは次に解決する価値があるものであり、ここでは解決されていません。

MIT。