fooddb-jp 0.2.0__tar.gz

fooddb_jp-0.2.0/.env.example

@@ -0,0 +1,12 @@
+# fooddb-jp 環境変数
+# ⚠️ このファイルは .gitignore に追加してください
+
+# Stripe (テストモード)
+STRIPE_SECRET_KEY=sk_test_XXXXXXXX
+STRIPE_WEBHOOK_SECRET=whsec_XXXXXXXX
+STRIPE_PRICE_DEVELOPER=price_1TCy31BtmXXkKBDksjW5nlzY
+STRIPE_PRICE_PRO=price_1TCy31BtmXXkKBDkwYFXiLgw
+
+# fooddb-jp
+FOODDB_ADMIN_KEY=fdb_admin_XXXXXXXX
+FOODDB_BASE_URL=https://fooddb.navii.online

fooddb_jp-0.2.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: [takakix2]

fooddb_jp-0.2.0/.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.pyc
+.venv/
+.uv/
+
+# IDE
+.vscode/
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temporary
+*.bak
+*.tmp
+
+# Large files (distributed via GitHub Releases)
+fooddb.sqlite
+data/raw/
+data/output/
+
+# Secrets
+.env

fooddb_jp-0.2.0/BILLING.md

@@ -0,0 +1,150 @@
+# BILLING.md — fooddb-jp 課金アーキテクチャ
+
+> 内部ドキュメント。Stripe 連携の構成、Webhook フロー、API キー管理の仕組み。
+
+---
+
+## アーキテクチャ概要
+
+```
+ユーザー
+  ↓ ランディングページ「Subscribe →」
+Stripe Checkout（Stripe ホスト）
+  ↓ 決済完了
+Stripe Webhook → POST /billing/webhook
+  ↓ checkout.session.completed
+API キー自動発行 → api_keys テーブルに INSERT
+  ↓
+ユーザーが MCP config に API キーを設定
+  ↓
+MCP / REST API リクエスト
+  ↓ Authorization: Bearer fdb_xxx
+check_rate_limit() → api_keys.requests_today +1
+```
+
+---
+
+## 料金プラン
+
+| プラン | 月額 | 日次上限 | 対象 |
+|---|---|---|---|
+| Free | ¥0 | 100 req/日 | 評価用。API キー不要 |
+| Developer | $9.99 | 10,000 req/日 | 個人開発者・小規模アプリ |
+| Pro | $29.99 | 100,000 req/日 | 商用アプリ・チーム |
+| Admin | — | 無制限 | 内部用（MCP サーバー等） |
+
+---
+
+## 環境変数
+
+```bash
+# .env に設定
+STRIPE_SECRET_KEY=sk_test_xxxx       # Stripe Secret Key
+STRIPE_WEBHOOK_SECRET=whsec_xxxx     # Webhook Signing Secret
+STRIPE_PRICE_DEVELOPER=price_xxxx    # Developer プランの Price ID
+STRIPE_PRICE_PRO=price_xxxx          # Pro プランの Price ID
+FOODDB_ADMIN_KEY=fdb_admin_xxxx      # 管理 API キー
+FOODDB_BASE_URL=https://fooddb.navii.online
+```
+
+---
+
+## Stripe 構成
+
+### Products & Prices（setup_stripe_products.py で作成済み）
+
+| Product | Price ID | 金額 | Billing |
+|---|---|---|---|
+| fooddb-jp Developer | `price_xxx` | $9.99/月 | Recurring (monthly) |
+| fooddb-jp Pro | `price_xxx` | $29.99/月 | Recurring (monthly) |
+
+### Webhook Events（/billing/webhook で処理）
+
+| Event | 処理内容 |
+|---|---|
+| `checkout.session.completed` | API キーを自動発行、`api_keys` テーブルに INSERT |
+| `customer.subscription.deleted` | `label=stripe:{subscription_id}` のキーを DELETE |
+| `customer.subscription.updated` | ログ記録（プラン変更・未払い検知） |
+| `invoice.payment_failed` | ログ記録（要通知実装） |
+
+---
+
+## API キー管理
+
+### テーブル構造（api_keys）
+
+```sql
+CREATE TABLE api_keys (
+    key TEXT PRIMARY KEY,           -- fdb_{hex32}
+    plan TEXT NOT NULL DEFAULT 'developer',
+    label TEXT DEFAULT '',          -- "stripe:{subscription_id}" or manual label
+    email TEXT DEFAULT '',
+    created_at TEXT NOT NULL,
+    requests_today INTEGER DEFAULT 0,
+    last_reset TEXT NOT NULL        -- "YYYY-MM-DD"
+);
+```
+
+### レート制限の仕組み
+
+1. リクエスト受信 → `check_rate_limit()` が `Authorization: Bearer` ヘッダーを確認
+2. API キーあり → `api_keys` テーブルで plan と requests_today を照合
+3. `last_reset` が今日でなければ → `requests_today = 0` にリセット
+4. `requests_today >= limit` なら → **429 Too Many Requests** 
+5. OK なら → `requests_today += 1`
+6. API キーなし → Free ティア（100 req/日、IP ベース制限は未実装）
+
+### 管理 API
+
+```bash
+# キー発行
+curl -X POST https://fooddb.navii.online/admin/keys \
+  -H "X-Admin-Key: $FOODDB_ADMIN_KEY" \
+  -G -d "plan=developer" -d "label=test-key" -d "email=user@example.com"
+
+# キー一覧
+curl https://fooddb.navii.online/admin/keys \
+  -H "X-Admin-Key: $FOODDB_ADMIN_KEY"
+
+# キー削除
+curl -X DELETE https://fooddb.navii.online/admin/keys/fdb_xxx \
+  -H "X-Admin-Key: $FOODDB_ADMIN_KEY"
+
+# 使用量確認（ユーザー向け）
+curl "https://fooddb.navii.online/billing/usage?api_key=fdb_xxx"
+```
+
+---
+
+## MCP からの課金フロー
+
+```
+MCP Server (ユーザーのマシン)
+  ↓ FOODDB_API_KEY=fdb_xxx
+  ↓ httpx GET /foods/search/オートミール
+  ↓ Authorization: Bearer fdb_xxx
+FastAPI (Mac Mini)
+  ↓ check_rate_limit()
+  ↓ api_keys.requests_today += 1
+  ↓ 応答
+MCP Server
+  ↓ JSON → テキスト整形
+AI エージェント
+```
+
+**MCP 経由でも REST API 経由でも、同一の認証・課金パスを通る。**
+
+---
+
+## TODO
+
+- [ ] Free ティアの IP ベースレート制限実装
+- [ ] 決済成功ページで API キーを表示する HTML ページ
+- [ ] メール通知（SendGrid 連携）で API キーを送信
+- [ ] 使用量ダッシュボード（`/billing/dashboard` — HTML）
+- [ ] 未払い時の自動キー停止（`invoice.payment_failed` → キー無効化）
+- [ ] Stripe Customer Portal（キャンセル・プラン変更のセルフサービス）
+
+---
+
+*作成: 2026-03-21*

fooddb_jp-0.2.0/DEPLOY_PLAN.md

@@ -0,0 +1,195 @@
+# fooddb-jp 公開デプロイ実装計画書
+
+> Cloudflare Tunnel で Mac Mini 上の FastAPI を公開し、無料/有料ティアで提供する。
+> Marrow 課金基盤のリハーサルを兼ねる。
+
+---
+
+## 1. アーキテクチャ
+
+```
+[ユーザー] → [Cloudflare CDN/WAF]
+                   ↓
+             [Cloudflare Tunnel]
+                   ↓
+             [Mac Mini (192.168.1.10)]
+                   ↓
+             [FastAPI :8800]  ← 既に動作中
+                   ↓
+             [SQLite (43MB)]
+```
+
+### なぜ Tunnel か（D1 ではなく）
+
+| 比較項目 | D1 方式 | Tunnel 方式 |
+|----------|---------|-------------|
+| コード書き直し | Python → TypeScript (Hono) | **不要**（FastAPI そのまま） |
+| FTS5 互換性 | D1 で使えるか不明 | **問題なし**（ローカル SQLite） |
+| Marrow との共通性 | Workers 側のみ | **アーキテクチャ全体が同じ** |
+| レイテンシ | エッジ実行で最速 | Tunnel 経由（数十ms追加） |
+| 可用性 | Cloudflare 管理 | Mac Mini に依存 |
+
+**結論**: Marrow のリハーサルが目的なので、Tunnel 方式が最適。
+
+---
+
+## 2. 技術スタック
+
+| レイヤー | 技術 | 役割 |
+|----------|------|------|
+| CDN/WAF | Cloudflare | DDoS防御、SSL終端、キャッシュ |
+| Tunnel | cloudflared | Mac Mini への暗号化トンネル |
+| API Server | FastAPI (api.py) | REST API（既存） |
+| DB | SQLite (fooddb.sqlite) | データストア（既存） |
+| レート制限 | Cloudflare WAF Rules | IP/APIキー単位 |
+| 課金 | Stripe | Webhook → APIキー発行 |
+
+---
+
+## 3. 実装ステップ
+
+### Phase A: Tunnel セットアップ + 公開 ✅ 完了（2026-03-19）
+
+```
+✅ 1. cloudflared v2026.3.0 確認済み（/usr/local/bin/cloudflared）
+✅ 2. Cloudflare 認証完了（navii.online）
+✅ 3. Tunnel 作成: fooddb-jp (ID: 1addee5b-0685-4ea8-a7a6-ded0b7af7d2a)
+✅ 4. DNS 設定: fooddb.navii.online → CNAME
+✅ 5. config.yml: ~/.cloudflared/config.yml
+✅ 6. 動作確認: https://fooddb.navii.online/ — 4コネクション (nrt09/12/16)
+□  7. systemd で常駐化（Mac Mini 移行時に実施）
+```
+
+**起動コマンド（手動）:**
+```bash
+# FastAPI
+cd ~/Documents/MyKnowledge_vault/50_Projects/fooddb-jp
+uv run uvicorn api:app --port 8800
+
+# Tunnel
+cloudflared tunnel run fooddb-jp
+```
+
+### Phase B: レート制限 + APIキー ✅ 完了（2026-03-19）
+
+```
+✅ 8. FastAPI に認証ミドルウェア実装
+     - Authorization: Bearer fdb_xxxxx
+     - キーの検証: ローカル SQLite テーブル
+     - キー無し = Free ティア（100 req/日）
+
+✅ 9. APIキー管理テーブル + 管理エンドポイント
+     - POST /admin/keys — キー発行
+     - GET  /admin/keys — キー一覧
+     - DELETE /admin/keys/{key} — キー無効化
+     - X-Admin-Key ヘッダーでマスター認証
+
+✅ 10. 3ティア料金設定（Free / Developer / Pro）
+      - 日次リセット（UTC 00:00）
+      - 429 Too Many Requests 返却
+```
+
+### Phase C: Stripe 課金連携 ✅ 完了（2026-03-20）
+
+```
+✅ 11. Stripe Product / Price 作成
+       - Product: fooddb-jp API
+       - Developer: $9.99/mo (price_1TCy31BtmXXkKBDksjW5nlzY)
+       - Pro: $29.99/mo (price_1TCy31BtmXXkKBDkwYFXiLgw)
+
+✅ 12. Stripe Checkout Webhook
+       - checkout.session.completed → api_keys テーブルにキー発行
+       - customer.subscription.deleted → キー無効化
+
+✅ 13. 課金エンドポイント追加（FastAPI）
+       POST /billing/checkout  → Stripe Checkout URL生成
+       GET  /billing/success   → 決済成功ページ
+       GET  /billing/cancel    → キャンセルページ
+       GET  /billing/usage     → 使用量確認
+
+✅ 14. Webhook 受信
+       POST /billing/webhook   → Stripe Signature 検証 + キー管理
+```
+
+### Phase D: 公開準備（1セッション）
+
+```
+□ 15. ドメイン設定
+      - DNS + SSL は Cloudflare 自動
+
+□ 16. ドキュメント
+      - OpenAPI / Swagger（FastAPI 自動生成）
+      - 登録手順・コード例
+
+□ 17. GitHub Public Repo
+      - SQLite + スクリプト = Public
+      - API キーは別管理
+
+□ 18. 告知（Product Hunt / Hacker News / Zenn）
+```
+
+---
+
+## 4. 料金プラン
+
+| プラン | 月額 | レート制限 | 認証 |
+|--------|------|-----------|------|
+| **Free** | ¥0 | 100 req/日 | 不要 |
+| **Developer** | $9.99/mo | 10,000 req/日 | APIキー |
+| **Pro** | $29.99/mo | 100,000 req/日 | APIキー |
+
+---
+
+## 5. Marrow へのフィードバック項目
+
+| 項目 | fooddb-jp で検証 | Marrow に適用 |
+|------|-----------------|---------------|
+| **Tunnel セットアップ** | 手順・信頼性・レイテンシ | 同じ構成を流用 |
+| **常駐化** | systemd/launchd の設定 | Marrow も同様に常駐 |
+| **Cloudflare WAF** | レート制限の粒度 | APIプラン制御 |
+| **Stripe Webhook** | 決済 → キー発行フロー | 課金フロー全体 |
+| **可用性** | Mac Mini ダウン時の挙動 | 運用ポリシーの判断材料 |
+| **レイテンシ** | Tunnel 経由の実測値 | SLA 設計の根拠 |
+
+---
+
+## 6. 投資対効果
+
+| コスト | 金額 |
+|--------|------|
+| Cloudflare Free プラン | ¥0 |
+| Tunnel | ¥0（Free プランに含む） |
+| ドメイン | $10/年 |
+| Stripe 手数料 | 3.6% + ¥40/件 |
+| Mac Mini 電気代 | 既存インフラ |
+| **合計追加費用** | **≒ ¥100/月** |
+
+**損益分岐点**: Developer プラン 1件で黒字
+
+---
+
+## 7. リスク・注意事項
+
+1. **Mac Mini の可用性**
+   - 停電・再起動時に API ダウン
+   - UPS + launchd 自動復帰で軽減
+   - Cloudflare が 502 を返すので、カスタムエラーページを設定
+
+2. **Tunnel のレイテンシ**
+   - ローカル実測: 3-5ms（同一筐体ループバック）
+   - 外部からの実測は未実施（日本国内: 10-30ms 追加の見込み）
+   - 読み取り専用 + 軽量クエリなので許容範囲
+
+3. **データ更新**
+   - 成分表は年1回更新（文科省）
+   - SQLite を差し替えて FastAPI 再起動のみ
+
+4. **著作権**
+   - 政府統計データ → 出典明記で自由利用可
+
+---
+
+*作成: 2026-03-18*
+*改訂: 2026-03-19（D1方式 → Tunnel方式に変更、Phase A 完了、Phase B 完了）*
+*改訂: 2026-03-20（Phase C 完了、GitHub 公開完了）*
+*Status: Phase A+B+C 完了 → Phase D（ドキュメント・告知）待ち*

fooddb_jp-0.2.0/LICENSE

@@ -0,0 +1,36 @@
+MIT License
+
+Copyright (c) 2025 takakix2
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Data License
+
+The food composition data included in this project is sourced from the
+"Standard Tables of Food Composition in Japan" (日本食品標準成分表)
+published by the Ministry of Education, Culture, Sports, Science and
+Technology (MEXT), Japan.
+
+This data is available under the Government of Japan Standard Terms of Use
+(Version 2.0), which is compatible with Creative Commons Attribution 4.0
+International (CC BY 4.0).
+
+Attribution: 文部科学省「日本食品標準成分表（八訂）増補2023年」

fooddb_jp-0.2.0/MCP_BILLING_PLAN.md

@@ -0,0 +1,244 @@
+# MCP → REST API 統合計画（課金ゲートウェイ化）
+
+> MCP Server が SQLite を直接読む構造を廃止し、REST API 経由に切り替える。
+> これにより MCP 経由の利用にも認証・レート制限・課金が適用される。
+
+---
+
+## 1. 現状の問題
+
+```
+REST API  → FastAPI (api.py)    → 認証 ✅ → レート制限 ✅ → 課金 ✅ → SQLite
+MCP Server → mcp_server.py      → 直接 SQLite 読み取り          ❌ 課金されない
+```
+
+### 影響
+- MCP 経由の利用が課金対象外
+- 検索ロジックが api.py と mcp_server.py に二重実装
+- エイリアス検索・FTS5 ロジックの同期コスト
+
+---
+
+## 2. 目標アーキテクチャ
+
+```
+MCP Server (mcp_server.py)
+    ↓ HTTP (httpx)
+REST API (FastAPI, api.py) — https://fooddb.navii.online/
+    ↓ 認証 + レート制限 + 課金
+SQLite (fooddb.sqlite)
+```
+
+### 原則
+- **MCP Server＝薄いラッパー**（REST API の結果を LLM 向けに整形するだけ）
+- **ビジネスロジック＝REST API に一本化**
+- **MCP Server は API キーを持つ**（環境変数 `FOODDB_API_KEY` で注入）
+
+---
+
+## 3. MCP ツール ↔ REST エンドポイント マッピング
+
+| MCP ツール | 現在の実装 | 対応 REST エンドポイント |
+|---|---|---|
+| `search_food(query, limit)` | 直接 SQL（4段フォールバック） | `GET /foods/search/{query}?limit=N` |
+| `get_food_nutrients(food_number, table)` | 直接 SQL（JOIN） | `GET /foods/{food_number}?table=T` |
+| `calculate_nutrition(foods_and_amounts)` | 直接 SQL（JOIN + 集計） | `GET /calculate?foods=1004:100,12004:60` |
+| `nutrient_ranking(tag, limit)` | 直接 SQL（ORDER BY） | `GET /ranking/{tag}?limit=N` |
+| `list_food_groups()` | 直接 SQL（GROUP BY） | `GET /groups` |
+
+**すべてのツールに対応するエンドポイントが既に存在する。** コードの書き換えのみで済む。
+
+---
+
+## 4. 実装ステップ
+
+### Step 1: MCP Server 用 API キーの発行
+
+Mac Mini 上で実行：
+```bash
+curl -X POST https://fooddb.navii.online/admin/keys \
+  -H "X-Admin-Key: $FOODDB_ADMIN_KEY" \
+  -G -d "plan=admin" -d "label=mcp-server-internal"
+```
+
+→ 発行されたキーを `.env` に追加：
+```
+FOODDB_API_KEY=fdb_xxxxxxxxxxxxxxxx
+```
+
+### Step 2: mcp_server.py の書き換え
+
+**Before（直接 DB アクセス）:**
+```python
+import sqlite3
+
+DB_PATH = Path(__file__).parent / "fooddb.sqlite"
+
+def get_db():
+    conn = sqlite3.connect(str(DB_PATH))
+    conn.row_factory = sqlite3.Row
+    return conn
+
+@mcp.tool()
+def search_food(query: str, limit: int = 10) -> str:
+    db = get_db()
+    rows = db.execute("SELECT ... WHERE food_name LIKE ?", ...)
+    # 100行以上の SQL ロジック
+    db.close()
+    return formatted_result
+```
+
+**After（REST API 経由）:**
+```python
+import httpx
+import os
+
+API_BASE = os.environ.get("FOODDB_API_URL", "https://fooddb.navii.online")
+API_KEY = os.environ.get("FOODDB_API_KEY", "")
+
+def _client() -> httpx.Client:
+    headers = {}
+    if API_KEY:
+        headers["Authorization"] = f"Bearer {API_KEY}"
+    return httpx.Client(base_url=API_BASE, headers=headers, timeout=10.0)
+
+@mcp.tool()
+def search_food(query: str, limit: int = 10) -> str:
+    """食品名であいまい検索する。例: 'オートミール', '鶏むね', '豆腐'"""
+    with _client() as c:
+        res = c.get(f"/foods/search/{query}", params={"limit": limit})
+        res.raise_for_status()
+        data = res.json()
+
+    if not data:
+        return f"「{query}」に一致する食品は見つかりませんでした。"
+
+    lines = [f"検索結果 ({len(data)}件):"]
+    for food in data:
+        parts = [f"{food['food_number']}: {food['food_name']}"]
+        meta = []
+        if food.get("group_name"): meta.append(food["group_name"])
+        if food.get("category"): meta.append(f"＜{food['category']}＞")
+        if meta: parts.append(f"({', '.join(meta)})")
+        lines.append(" ".join(parts))
+    return "\n".join(lines)
+```
+
+### Step 3: 各ツールの書き換え
+
+| ツール | API コール | 整形 |
+|---|---|---|
+| `search_food` | `GET /foods/search/{query}` | JSON → テキスト一覧 |
+| `get_food_nutrients` | `GET /foods/{number}?table=T` | JSON → 成分表テキスト |
+| `calculate_nutrition` | `GET /calculate?foods=...` | JSON → 栄養素合計テキスト |
+| `nutrient_ranking` | `GET /ranking/{tag}?limit=N` | JSON → ランキングテキスト |
+| `list_food_groups` | `GET /groups` | JSON → グループ一覧テキスト |
+
+### Step 4: REST API 側の微調整
+
+現在の REST API レスポンスを確認し、MCP から使いやすい形になっているか検証。
+不足があれば追加：
+
+- [ ] `/foods/search/{query}` — カテゴリ・サブカテゴリ情報が含まれるか確認
+- [ ] `/calculate` — 主要栄養素の優先表示順が API 側にもあるか確認
+- [ ] エラーレスポンスの統一（404, 400 のフォーマット）
+
+### Step 5: 依存関係の更新
+
+```bash
+uv add httpx  # mcp_server.py の新しい依存
+uv remove sqlite3  # 不要になる（標準ライブラリなので実際は不要）
+```
+
+### Step 6: テスト
+
+1. **ユニットテスト**: MCP ツールが正しい REST エンドポイントを呼ぶか
+2. **統合テスト**: MCP 経由で検索 → API キーのカウンタが増加するか
+3. **レート制限テスト**: Free キーで 100 回超えたら MCP も 429 になるか
+
+```bash
+# 統合テスト例
+uv run python -c "
+from mcp_server import search_food
+result = search_food('米', 3)
+print(result)
+"
+# → API の requests_today が +1 されていることを確認
+```
+
+### Step 7: Mac Mini へのデプロイ
+
+```bash
+# Mac Mini にSSH
+ssh takaki@192.168.1.10
+
+# コード更新
+cd ~/projects/fooddb-jp
+git pull
+
+# .env に API キーを追加
+echo 'FOODDB_API_KEY=fdb_xxx' >> .env
+
+# サービス再起動（systemd）
+sudo systemctl restart fooddb-api
+```
+
+---
+
+## 5. 削除されるコード
+
+mcp_server.py から削除される部分：
+- `sqlite3` import と `DB_PATH` 定義
+- `get_db()` 関数
+- 各ツール内の SQL クエリ（合計 ~150行）
+- エイリアス交差検索ロジック（api.py に一本化済み）
+
+**mcp_server.py は ~260行 → ~100行 に縮小**
+
+---
+
+## 6. 副次効果
+
+| Before | After |
+|---|---|
+| MCP は SQLite を直接読む（課金外） | **全アクセスが課金対象** |
+| 検索ロジックが2箇所に存在 | **api.py に一本化** |
+| mcp_server.py が DB ファイルに依存 | **URL だけ知っていれば動く** |
+| Mac Mini 上でしか MCP が動かない | **どこからでも REST 経由で接続可能** |
+| MCP の食品検索品質 ≠ API の検索品質 | **同一のロジックを共有** |
+
+---
+
+## 7. Marrow への水平展開
+
+この「MCP = 薄いラッパー / REST API = 課金ゲートウェイ」パターンは、
+Marrow の MCP Server にもそのまま適用できる：
+
+```
+Marrow MCP Server
+    ↓ HTTP
+Marrow REST API (Cloudflare Workers)
+    ↓ 認証 + 課金 (Stripe)
+Marrow Gateway (Crawler Engine)
+```
+
+fooddb-jp をこのパターンの **最初の実証例** として確立する。
+
+---
+
+## 8. 工数見積
+
+| ステップ | 工数 |
+|---|---|
+| Step 1: API キー発行 | 1分 |
+| Step 2-3: mcp_server.py 書き換え | 30分 |
+| Step 4: REST API 微調整 | 15分 |
+| Step 5: 依存関係更新 | 5分 |
+| Step 6: テスト | 15分 |
+| Step 7: デプロイ | 10分 |
+| **合計** | **~1.5時間** |
+
+---
+
+*作成: 2026-03-21*
+*Status: 計画完了 → 実装待ち*