food402 1.0.4-beta.1 → 1.1.1

package/README.md

@@ -2,9 +2,22 @@
 
 [![npm version](https://img.shields.io/npm/v/food402.svg)](https://www.npmjs.com/package/food402)
 
-An MCP (Model Context Protocol) server that enables AI assistants to order food from TGO Yemek. Simply chat with your AI assistant to browse restaurants, build your order, and complete checkout.
+An MCP (Model Context Protocol) server that enables AI assistants to order food from TGO Yemek. Simply chat with your AI assistant to browse restaurants, build your order, and complete checkout. Works with Claude, ChatGPT (Developer Mode), and Codex CLI via MCP.
 
-## Installation
+## Deployment Options
+
+Food402 supports two deployment methods:
+
+| Method | Best For | Transport | Auth |
+|--------|----------|-----------|------|
+| **Local MCP Server** | Claude Desktop, Claude Code, ChatGPT (Developer Mode), Codex CLI | stdio | Environment variables |
+| **Remote MCP Server** | Claude.ai (web) | HTTP | OAuth 2.0 |
+
+---
+
+## Local MCP Server (npm package)
+
+### Claude Desktop
 
 Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
 
@@ -25,7 +38,7 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
 
 Replace `your-email@example.com` and `your-password` with your TGO Yemek credentials.
 
-## Local Installation (Claude Code)
+### Claude Code
 
 For project-specific installation with Claude Code:
 
@@ -33,14 +46,14 @@ For project-specific installation with Claude Code:
 npm install food402
 ```
 
-This automatically adds `food402` to your `.mcp.json`. Open the file and update your credentials:
+This automatically adds `food402` to your `.mcp.json` and creates/updates `.codex/config.toml` for Codex CLI. Open the file(s) and update your credentials:
 
 ```json
 {
   "mcpServers": {
     "food402": {
       "command": "node",
-      "args": ["./node_modules/food402/dist/index.js"],
+      "args": ["./node_modules/food402/dist/src/index.js"],
       "env": {
         "TGO_EMAIL": "your-email@example.com",
         "TGO_PASSWORD": "your-password"
@@ -50,6 +63,72 @@ This automatically adds `food402` to your `.mcp.json`. Open the file and update
 }
 ```
 
+---
+
+### ChatGPT (Developer Mode)
+
+ChatGPT apps in Developer Mode can connect to local MCP servers over stdio. Use the same local server configuration and provide your credentials as environment variables.
+
+1. Open ChatGPT **Settings > Developer** (or your app’s Developer Mode settings)
+2. Add a **Custom MCP Server**
+3. Set the command to run the local server:
+
+```json
+{
+  "command": "npx",
+  "args": ["-y", "food402"],
+  "env": {
+    "TGO_EMAIL": "your-email@example.com",
+    "TGO_PASSWORD": "your-password"
+  }
+}
+```
+
+> **Tip:** If your ChatGPT client supports project-level MCP config files, you can reuse the same JSON from Claude Code (`.mcp.json`) with the command above.
+
+### Codex CLI (Terminal)
+
+Codex supports MCP servers over stdio and uses TOML config files (not `.mcp.json`). You can add servers via the CLI (global) or a project-scoped `.codex/config.toml` (trusted projects).
+
+**Option A: CLI (global config: `~/.codex/config.toml`)**
+
+```bash
+codex mcp add food402 --env TGO_EMAIL=your-email@example.com --env TGO_PASSWORD=your-password -- npx -y food402
+```
+
+**Option B: Project config (`.codex/config.toml`)**
+
+```toml
+[mcp_servers.food402]
+command = "node"
+args = ["./node_modules/food402/dist/src/index.js"]
+
+[mcp_servers.food402.env]
+TGO_EMAIL = "your-email@example.com"
+TGO_PASSWORD = "your-password"
+```
+
+> **Tip:** Installing via `npm install food402` will create or update `.codex/config.toml` in the project root and add the `food402` entry automatically.
+
+---
+
+## Remote MCP Server (Claude.ai Web)
+
+For Claude.ai web access, use the remote MCP server deployed on Cloudflare Workers.
+
+### Connect to Claude.ai
+
+1. Go to Claude.ai **Settings > Connectors**
+2. Click **"Add Custom Connector"**
+3. Enter the server URL: `https://food402-remote.food402.workers.dev`
+4. Complete the OAuth flow by logging in with your TGO Yemek credentials
+
+No local setup required—your credentials are securely stored via OAuth.
+
+> **Self-hosting?** See [remote/README.md](./remote/README.md) for deployment instructions.
+
+---
+
 ## Prerequisites
 
 ### Account Setup Required
@@ -131,11 +210,35 @@ Here's the typical workflow when ordering food through the AI assistant:
 
 ## Development
 
-```bash
-# Clone the repository
-git clone https://github.com/rersozlu/food402.git
-cd food402
+### Repository Structure
+
+```
+food402/
+├── src/                    # Local MCP server (stdio transport)
+│   ├── index.ts            # MCP entry point with tool definitions
+│   ├── auth.ts             # TGO auth with token caching
+│   ├── api.ts              # Thin wrapper around shared/api.ts
+│   └── postinstall.ts      # Auto-configures .mcp.json on npm install
+├── shared/                 # Shared code between local and remote
+│   ├── api.ts              # Token-parameterized TGO API functions
+│   └── types.ts            # TypeScript interfaces
+├── remote/                 # Remote MCP server (HTTP transport)
+│   ├── src/
+│   │   ├── worker.ts       # Cloudflare Worker entry (Hono)
+│   │   ├── server.ts       # MCP server with tool definitions
+│   │   ├── auth/           # OAuth 2.0 provider + TGO login
+│   │   ├── payment/        # 3DS verification page handler
+│   │   └── session/        # Encrypted session management
+│   ├── wrangler.toml       # CF Workers config
+│   └── package.json        # Remote-specific dependencies
+├── package.json            # Root package (npm: food402)
+├── README.md
+└── CLAUDE.md
+```
 
+### Local Server Development
+
+```bash
 # Install dependencies
 npm install
 
@@ -146,6 +249,23 @@ npm start
 npm run build
 ```
 
+### Remote Server Development
+
+```bash
+cd remote
+
+# Install dependencies
+npm install
+
+# Run local dev server (http://localhost:8787)
+npm run dev
+
+# Deploy to Cloudflare Workers
+npm run deploy
+```
+
+See [remote/README.md](./remote/README.md) for full deployment instructions including KV namespace setup and secrets configuration.
+
 ## License
 
 MIT

package/dist/src/postinstall.js

@@ -1,17 +1,27 @@
 #!/usr/bin/env node
-import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
 // Find project root (where npm install was run)
 const projectRoot = process.env.INIT_CWD || process.cwd();
 const mcpJsonPath = join(projectRoot, '.mcp.json');
+const codexConfigPath = join(projectRoot, '.codex', 'config.toml');
 const food402Config = {
     command: "node",
-    args: ["./node_modules/food402/dist/index.js"],
+    args: ["./node_modules/food402/dist/src/index.js"],
     env: {
         TGO_EMAIL: "your-email@example.com",
         TGO_PASSWORD: "your-password"
     }
 };
+const codexConfigBlock = [
+    '[mcp_servers.food402]',
+    'command = "node"',
+    'args = ["./node_modules/food402/dist/src/index.js"]',
+    '',
+    '[mcp_servers.food402.env]',
+    'TGO_EMAIL = "your-email@example.com"',
+    'TGO_PASSWORD = "your-password"'
+].join('\n');
 let config = { mcpServers: {} };
 if (existsSync(mcpJsonPath)) {
     try {
@@ -23,7 +33,38 @@ if (existsSync(mcpJsonPath)) {
         // Invalid JSON, start fresh
     }
 }
-config.mcpServers.food402 = food402Config;
-writeFileSync(mcpJsonPath, JSON.stringify(config, null, 2) + '\n');
-console.log('✓ Added food402 to .mcp.json');
-console.log('→ Update TGO_EMAIL and TGO_PASSWORD in .mcp.json with your credentials');
+if (config.mcpServers.food402) {
+    console.log('✓ food402 already present in .mcp.json');
+}
+else {
+    config.mcpServers.food402 = food402Config;
+    writeFileSync(mcpJsonPath, JSON.stringify(config, null, 2) + '\n');
+    console.log('✓ Added food402 to .mcp.json');
+    console.log('→ Update TGO_EMAIL and TGO_PASSWORD in .mcp.json with your credentials');
+}
+let codexConfig = '';
+if (existsSync(codexConfigPath)) {
+    try {
+        codexConfig = readFileSync(codexConfigPath, 'utf-8');
+    }
+    catch {
+        codexConfig = '';
+    }
+}
+if (codexConfig.includes('[mcp_servers.food402]')) {
+    console.log('✓ food402 already present in .codex/config.toml');
+}
+else {
+    mkdirSync(join(projectRoot, '.codex'), { recursive: true });
+    let nextCodexConfig = codexConfig;
+    if (nextCodexConfig.length && !nextCodexConfig.endsWith('\n')) {
+        nextCodexConfig += '\n';
+    }
+    if (nextCodexConfig.length) {
+        nextCodexConfig += '\n';
+    }
+    nextCodexConfig += codexConfigBlock + '\n';
+    writeFileSync(codexConfigPath, nextCodexConfig);
+    console.log('✓ Added food402 to .codex/config.toml');
+    console.log('→ Update TGO_EMAIL and TGO_PASSWORD in .codex/config.toml with your credentials');
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "food402",
-  "version": "1.0.4-beta.1",
+  "version": "1.1.1",
   "description": "MCP server for ordering food from TGO Yemek",
   "type": "module",
   "bin": {
-    "food402": "./dist/index.js"
+    "food402": "./dist/src/index.js"
   },
   "files": [
     "dist"
@@ -12,7 +12,7 @@
   "scripts": {
     "start": "tsx src/index.ts",
     "build": "tsc",
-    "postinstall": "node dist/postinstall.js",
+    "postinstall": "node dist/src/postinstall.js",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/dist/api.d.ts

@@ -1,417 +0,0 @@
-export interface Address {
-    id: number;
-    name: string;
-    surname: string;
-    phone: string;
-    countryPhoneCode: string;
-    addressLine: string;
-    addressName: string;
-    postalCode: string;
-    cityId: number;
-    cityName: string;
-    districtId: number;
-    districtName: string;
-    neighborhoodId: number;
-    neighborhoodName: string;
-    latitude: string;
-    longitude: string;
-    addressDescription: string;
-    apartmentNumber: string;
-    floor: string;
-    doorNumber: string;
-    addressType: string;
-    elevatorAvailable: boolean;
-}
-export interface AddressesResponse {
-    infoMessage: string | null;
-    id: string;
-    addresses: Address[];
-}
-export interface Restaurant {
-    id: number;
-    name: string;
-    kitchen: string;
-    rating: number;
-    ratingText: string;
-    minBasketPrice: number;
-    averageDeliveryInterval: string;
-    distance: number;
-    neighborhoodName: string;
-    isClosed: boolean;
-    campaignText?: string;
-}
-export interface RestaurantsResponse {
-    restaurants: Restaurant[];
-    totalCount: number;
-    currentPage: number;
-    pageSize: number;
-    hasNextPage: boolean;
-}
-export declare function getAddresses(): Promise<AddressesResponse>;
-export interface MenuItem {
-    id: number;
-    name: string;
-    description: string;
-    price: number;
-    likePercentage?: string;
-}
-export interface MenuCategory {
-    name: string;
-    slug: string;
-    items: MenuItem[];
-}
-export interface RestaurantInfo {
-    id: number;
-    name: string;
-    status: string;
-    rating: number;
-    ratingText: string;
-    workingHours: string;
-    deliveryTime: string;
-    minOrderPrice: number;
-}
-export interface RestaurantMenuResponse {
-    info: RestaurantInfo;
-    categories: MenuCategory[];
-    totalItems: number;
-}
-export declare function getRestaurants(latitude: string, longitude: string, page?: number): Promise<RestaurantsResponse>;
-export declare function getRestaurantMenu(restaurantId: number, latitude: string, longitude: string): Promise<RestaurantMenuResponse>;
-export interface RecommendedItem {
-    id: number;
-    name: string;
-    description: string | null;
-    price: number;
-    imageUrl: string;
-}
-export interface RecommendationCollection {
-    name: string;
-    items: RecommendedItem[];
-}
-export interface ProductRecommendationsResponse {
-    collections: RecommendationCollection[];
-    totalItems: number;
-}
-export declare function getProductRecommendations(restaurantId: number, productIds: number[]): Promise<ProductRecommendationsResponse>;
-export interface ProductOption {
-    id: number;
-    name: string;
-    price: number;
-    selected: boolean;
-    isPopular?: boolean;
-}
-export interface ProductComponent {
-    type: "INGREDIENTS" | "MODIFIER_GROUP";
-    title: string;
-    description?: string;
-    modifierGroupId?: number;
-    options: ProductOption[];
-    isSingleChoice: boolean;
-    minSelections: number;
-    maxSelections: number;
-}
-export interface ProductDetailsResponse {
-    restaurantId: number;
-    restaurantName: string;
-    productId: number;
-    productName: string;
-    description: string;
-    imageUrl: string;
-    price: number;
-    maxQuantity: number;
-    components: ProductComponent[];
-}
-export declare function getProductDetails(restaurantId: number, productId: number, latitude: string, longitude: string): Promise<ProductDetailsResponse>;
-export interface IngredientExclusion {
-    id: number;
-}
-export interface ModifierProduct {
-    productId: number;
-    modifierGroupId: number;
-    modifierProducts: ModifierProduct[];
-    ingredientOptions: {
-        excludes: IngredientExclusion[];
-        includes: [];
-    };
-}
-export interface BasketItem {
-    productId: number;
-    quantity: number;
-    modifierProducts: ModifierProduct[];
-    ingredientOptions: {
-        excludes: IngredientExclusion[];
-        includes: [];
-    };
-}
-export interface AddToBasketRequest {
-    storeId: number;
-    items: BasketItem[];
-    isFlashSale: boolean;
-    storePickup: boolean;
-    latitude: number;
-    longitude: number;
-}
-export interface CartProduct {
-    productId: number;
-    itemId: string;
-    name: string;
-    quantity: number;
-    salePrice: number;
-    description: string;
-}
-export interface CartStore {
-    id: number;
-    name: string;
-    imageUrl: string;
-    rating: number;
-    averageDeliveryInterval: string;
-    minAmount: number;
-}
-export interface CartSummaryLine {
-    title: string;
-    amount: number;
-    isPromotion?: boolean;
-}
-export interface AddToBasketResponse {
-    store: CartStore;
-    products: CartProduct[];
-    summary: CartSummaryLine[];
-    totalProductCount: number;
-    totalProductPrice: number;
-    totalProductPriceDiscounted: number;
-    totalPrice: number;
-    deliveryPrice: number;
-}
-export interface SetShippingAddressRequest {
-    shippingAddressId: number;
-    invoiceAddressId: number;
-}
-export declare function setShippingAddress(request: SetShippingAddressRequest): Promise<void>;
-export declare function addToBasket(request: AddToBasketRequest): Promise<AddToBasketResponse>;
-export interface CartProductDetails extends CartProduct {
-    marketPrice: number;
-    modifierProducts: Array<{
-        productId: number;
-        modifierGroupId: number;
-        name: string;
-        price: number;
-    }>;
-    ingredientExcludes: Array<{
-        id: number;
-        name: string;
-    }>;
-}
-export interface CartStoreGroup {
-    store: CartStore;
-    products: CartProductDetails[];
-}
-export interface GetBasketResponse {
-    storeGroups: CartStoreGroup[];
-    summary: CartSummaryLine[];
-    totalProductCount: number;
-    totalProductPrice: number;
-    totalProductPriceDiscounted: number;
-    totalPrice: number;
-    deliveryPrice: number;
-    isEmpty: boolean;
-}
-export declare function getBasket(): Promise<GetBasketResponse>;
-export declare function removeFromBasket(itemId: string): Promise<GetBasketResponse>;
-export declare function clearBasket(): Promise<void>;
-export interface SearchProduct {
-    id: number;
-    name: string;
-    description?: string;
-    price: number;
-    imageUrl?: string;
-}
-export interface SearchRestaurant extends Restaurant {
-    products: SearchProduct[];
-    warning?: string;
-}
-export interface SearchRestaurantsResponse {
-    restaurants: SearchRestaurant[];
-    totalCount: number;
-    currentPage: number;
-    pageSize: number;
-    hasNextPage: boolean;
-    searchQuery: string;
-}
-export interface City {
-    id: number;
-    code: string;
-    name: string;
-}
-export interface District {
-    id: number;
-    name: string;
-}
-export interface Neighborhood {
-    id: number;
-    name: string;
-}
-export interface CitiesResponse {
-    cities: City[];
-    count: number;
-}
-export interface DistrictsResponse {
-    districts: District[];
-    count: number;
-    cityId: number;
-}
-export interface NeighborhoodsResponse {
-    neighborhoods: Neighborhood[];
-    count: number;
-    districtId: number;
-}
-export declare function getCities(): Promise<CitiesResponse>;
-export declare function getDistricts(cityId: number): Promise<DistrictsResponse>;
-export declare function getNeighborhoods(districtId: number): Promise<NeighborhoodsResponse>;
-export interface AddAddressRequest {
-    name: string;
-    surname: string;
-    phone: string;
-    apartmentNumber?: string;
-    floor?: string;
-    doorNumber?: string;
-    addressName: string;
-    addressDescription?: string;
-    addressLine: string;
-    cityId: number;
-    districtId: number;
-    neighborhoodId: number;
-    latitude: string;
-    longitude: string;
-    countryCode?: string;
-    elevatorAvailable?: boolean;
-}
-export interface AddAddressResponse {
-    success: boolean;
-    address?: Address;
-    requiresOtp?: boolean;
-    message: string;
-}
-export declare function addAddress(request: AddAddressRequest): Promise<AddAddressResponse>;
-export interface SavedCard {
-    cardId: number;
-    name: string;
-    maskedCardNumber: string;
-    cardTypeName: string;
-    bankName: string;
-    isDebitCard: boolean;
-    cvvRequired: boolean;
-    cardNetwork: string;
-}
-export interface SavedCardsResponse {
-    cards: SavedCard[];
-    hasCards: boolean;
-    message?: string;
-}
-export interface CheckoutReadyResponse {
-    ready: boolean;
-    store: CartStore;
-    products: CartProductDetails[];
-    summary: CartSummaryLine[];
-    totalPrice: number;
-    deliveryPrice: number;
-    warnings: string[];
-}
-export interface PlaceOrderResponse {
-    success: boolean;
-    orderId?: string;
-    requires3DSecure?: boolean;
-    redirectUrl?: string;
-    htmlContent?: string;
-    message: string;
-}
-export interface CustomerNoteRequest {
-    customerNote: string;
-    noServiceWare: boolean;
-    contactlessDelivery: boolean;
-    dontRingBell: boolean;
-}
-export declare function updateCustomerNote(request: CustomerNoteRequest): Promise<void>;
-export declare function getSavedCards(): Promise<SavedCardsResponse>;
-export declare function getCheckoutReady(): Promise<CheckoutReadyResponse>;
-export declare function placeOrder(cardId: number): Promise<PlaceOrderResponse>;
-export interface OrderStatus {
-    status: string;
-    statusText: string;
-    statusColor: string;
-}
-export interface OrderStore {
-    id: number;
-    name: string;
-}
-export interface OrderPrice {
-    totalPrice: number;
-    totalPriceText: string;
-    refundedPrice: number;
-    cancelledPrice: number;
-    totalDeliveryPrice: number;
-    totalServicePrice: number;
-}
-export interface OrderProductSummary {
-    productId: number;
-    name: string;
-    imageUrl: string;
-}
-export interface Order {
-    id: string;
-    orderDate: string;
-    store: OrderStore;
-    status: OrderStatus;
-    price: OrderPrice;
-    productSummary: string;
-    products: OrderProductSummary[];
-    isReady: boolean;
-}
-export interface OrdersResponse {
-    orders: Order[];
-    pagination: {
-        currentPage: number;
-        pageSize: number;
-        totalCount: number;
-        hasNext: boolean;
-    };
-}
-export interface OrderDetailProduct {
-    name: string;
-    imageUrl: string;
-    salePrice: number;
-    salePriceText: string;
-    quantity: number;
-    description: string;
-}
-export interface OrderStatusStep {
-    status: string;
-    statusText: string;
-}
-export interface OrderShipmentItem {
-    status: OrderStatus;
-    statusSteps: OrderStatusStep[];
-    products: OrderDetailProduct[];
-}
-export interface OrderDetail {
-    orderId: string;
-    orderNumber: string;
-    orderDate: string;
-    customerNote: string;
-    store: OrderStore;
-    eta: string;
-    deliveredDate: string;
-    status: OrderStatus;
-    statusSteps: OrderStatusStep[];
-    products: OrderDetailProduct[];
-    price: OrderPrice;
-    paymentDescription: string;
-    deliveryAddress: {
-        name: string;
-        address: string;
-        districtCity: string;
-        phoneNumber: string;
-    };
-}
-export declare function getOrders(page?: number): Promise<OrdersResponse>;
-export declare function getOrderDetail(orderId: string): Promise<OrderDetail>;
-export declare function searchRestaurants(searchQuery: string, latitude: string, longitude: string, page?: number): Promise<SearchRestaurantsResponse>;