foodservice-kpi-mcp-server

飲食業向けの主要KPI計算と簡易シミュレーションを提供する、オープンソースのMCPサーバーです。

概要

このプロジェクトは、飲食店運営でよく使う指標や損益の見立てを、監査しやすい明示的な計算ロジックとして提供します。

対象ユーザー:

• 小規模、中規模の飲食事業者
• 店舗責任者
• 簡易的な数値確認を行うバックオフィス担当者
• AIワークフローに飲食業KPIツールを組み込みたい開発者

v0.1のスコープ

以下のツールを提供します。

• calculate_fl_ratio
• calculate_flr_ratio
• calculate_flaro_ratio
• calculate_break_even_sales
• simulate_labor_cost_ratio
• simulate_sales_from_basic_assumptions
• generate_simple_pl

このリポジトリの方針

• 数式を明示する
• 小さく組み合わせやすいツールに分ける
• 入力バリデーションを明確にする
• ベンダー依存をコアロジックに持ち込まない
• ローカルで扱いやすい構成にする

このリポジトリは、会計、税務、法務、労務、コンプライアンス上の助言を提供するものではありません。

セットアップ

python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
pytest

stdio でMCPサーバーを起動する例:

foodservice-kpi-mcp-server

構成

• SSOT.md: このリポジトリの最上位仕様
• src/foodservice_kpi_mcp/domain/: 純粋な計算ロジック
• src/foodservice_kpi_mcp/tools/: MCP公開用の薄いラッパー
• src/foodservice_kpi_mcp/server.py: MCPサーバーの起動とツール登録
• tests/: ドメイン計算のテスト

開発

• Python 3.11以上
• テスト: pytest
• Lint/Format: ruff

ライセンス

MIT