Food402

🚀 Food402 MCPサーバー

このMCP（Model Context Protocol）サーバーは、AIアシスタントがTGO Yemekから食事を注文できるようにします。AIアシスタントとチャットするだけで、レストランを閲覧し、注文を作成し、決済を完了できます。Claude、ChatGPT（Developer Mode）、Codex CLIとMCPを介して連携します。

Clawdbot / OpenClaw (AgentSkills)

Food402は、ClawHub上のAgentSkillとしても利用でき、Clawdbot (OpenClaw)、Claude Code、Cursor、Codex、Gemini CLI、およびその他のAgentSkills互換ツールと一緒に使用できます。

ClawHub経由でインストールする場合：

clawhub install rersozlu/food402

または手動でインストールする場合： skill/フォルダを~/.openclaw/skills/food402/にコピーし、~/.openclaw/openclaw.jsonで資格情報を設定します。

ローカルMCPサーバー（npmパッケージ）

Claude Desktop

Claude Desktopの設定ファイル（macOSでは~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "food402": {
      "command": "npx",
      "args": ["-y", "food402"],
      "env": {
        "TGO_EMAIL": "your-email@example.com",
        "TGO_PASSWORD": "your-password",
        "GOOGLE_PLACES_API_KEY": "your-google-api-key"
      }
    }
  }
}

資格情報は自分のものに置き換えてください。GOOGLE_PLACES_API_KEYはオプションです（オプション機能を参照）。

Claude Code

Claude Codeでプロジェクト固有のインストールを行う場合：

npm install food402

これにより、food402が自動的に.mcp.jsonに追加されます。このファイルを開き、資格情報を更新します。

{
  "mcpServers": {
    "food402": {
      "command": "node",
      "args": ["./node_modules/food402/dist/src/index.js"],
      "env": {
        "TGO_EMAIL": "your-email@example.com",
        "TGO_PASSWORD": "your-password",
        "GOOGLE_PLACES_API_KEY": "your-google-api-key"
      }
    }
  }
}

GOOGLE_PLACES_API_KEYはオプションです（オプション機能を参照）。

Codex CLI（ターミナル）

Codexは、グローバル設定ファイル~/.codex/config.tomlからMCPサーバーを読み取ります。

オプションA：CLI経由

codex mcp add food402 --env TGO_EMAIL=your-email@example.com --env TGO_PASSWORD=your-password --env GOOGLE_PLACES_API_KEY=your-google-api-key -- npx -y food402

オプションB：手動設定

~/.codex/config.tomlに以下を追加します。

[mcp_servers.food402]
command = "npx"
args = ["-y", "food402"]

[mcp_servers.food402.env]
TGO_EMAIL = "your-email@example.com"
TGO_PASSWORD = "your-password"
GOOGLE_PLACES_API_KEY = "your-google-api-key"  # オプション

前提条件

アカウント設定が必要

このMCPサーバーを使用する前に、以下の条件を満たすTGO Yemekアカウントが必要です。

1. TGO Yemekアカウント - 持っていない場合は、tgoyemek.comで作成してください。
2. アカウントに保存された支払いカード - 決済プロセスでは保存されたカードが必要です。注文時にカード詳細を入力することはできません。
3. 少なくとも1つの配送先住所が保存されていること（推奨） - MCPを通じて住所を追加することもできますが、事前に設定しておくと注文がスムーズになります。

🚀 クイックスタート：注文フロー

AIアシスタントを通じて食事を注文する際の典型的なワークフローは以下の通りです。

1. 配送先住所を選択する

"Show me my saved addresses"
"Select my home address for delivery"

2. レストランを探す

"What restaurants are near me?"
"Search for pizza restaurants"
"Find places that serve lahmacun"

3. メニューを閲覧し、商品を追加する

"Show me the menu for [restaurant name]"
"Add 2 lahmacun to my cart"
"What customization options are available for this item?"

4. 注文内容を確認し、決済する

"Show me my basket"
"Remove the drink from my order"
"I'm ready to checkout"

5. 注文を確定する

"Place my order using my saved card"

注：3Dセキュア認証のためにブラウザウィンドウが開きます。認証を完了して注文を確定してください。

6. 注文状況を追跡する

"What's the status of my order?"
"Show me my recent orders"

✨ 利用可能なツール

🔧 オプション機能

Googleレビューの統合

get_google_reviewsツールを使用すると、レストランのGoogleレビューを取得でき、TGOの評価とGoogleの評価を比較することができます。この機能はオプションで、Google Places APIキーが必要です。

Googleレビューを有効にするには：

1. Google Cloud ConsoleからGoogle Places APIキーを取得します。
2. プロジェクトに両方のAPIを有効にします（両方が必要です）：
   • Places API (New) - レストランを見つけるためのテキスト検索に使用されます。
   • Places API - 場所の詳細とレビューを取得するために使用されます。
3. MCPサーバーの設定にキーを追加します。

{
  "mcpServers": {
    "food402": {
      "command": "npx",
      "args": ["-y", "food402"],
      "env": {
        "TGO_EMAIL": "your-email@example.com",
        "TGO_PASSWORD": "your-password",
        "GOOGLE_PLACES_API_KEY": "your-google-api-key"
      }
    }
  }
}

APIキーがない場合： ツールは機能が利用できないことを示すメッセージを返しますが、エラーは発生しません。APIキーがなくても、食事注文機能の残りの部分は正常に動作します。

🛠️ 開発

リポジトリ構造

food402/
├── src/                    # MCPサーバー（stdioトランスポート）
│   ├── index.ts            # ツール定義を含むMCPエントリポイント
│   ├── auth.ts             # トークンキャッシュを持つTGO認証
│   ├── api.ts              # shared/api.tsの薄いラッパー
│   └── postinstall.ts      # npmインストール時に.mcp.jsonを自動設定する
├── shared/                 # 共有APIコード
│   ├── api.ts              # トークンパラメータ化されたTGO API関数
│   └── types.ts            # TypeScriptインターフェース
├── test/                   # テストスイート
│   ├── integration/        # API統合テスト
│   ├── security/           # セキュリティ検証テスト
│   └── setup/              # テストユーティリティとフィクスチャ
├── package.json            # ルートパッケージ（npm: food402）
├── README.md
└── CLAUDE.md

ローカルサーバーの開発

# 依存関係をインストールする
npm install

# 開発モードで実行する
npm start

# TypeScriptをビルドする
npm run build

テスト

このプロジェクトには、Vitestを使用した統合テストとセキュリティテストが含まれています。

# すべてのテストを実行する
npm test

# セキュリティテストのみを実行する
npm run test:security

# カバレッジ付きでテストを実行する
npm run test:coverage

テストのセットアップ：

1. test/.env.test.exampleをtest/.env.testにコピーします。
2. test/.env.testにTGOの資格情報を追加します。
3. npm testを実行します。

テストの対象は以下の通りです。

• 住所管理（都市、地区、近隣）
• レストランの発見とメニューの閲覧
• カート操作
• 支払いカードの取得と決済準備
• 注文履歴
• 資格情報の取り扱いに関するセキュリティチェック

📄 ライセンス

MIT