food402 1.0.4-beta.1 → 1.1.0

package/README.md

@@ -4,7 +4,20 @@
 
 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.
 
-## Installation
+## Deployment Options
+
+Food402 supports two deployment methods:
+
+| Method | Best For | Transport | Auth |
+|--------|----------|-----------|------|
+| **Local MCP Server** | Claude Desktop, Claude Code | 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:
 
@@ -40,7 +53,7 @@ This automatically adds `food402` to your `.mcp.json`. Open the file and update
   "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,25 @@ This automatically adds `food402` to your `.mcp.json`. Open the file and update
 }
 ```
 
+---
+
+## 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 remote server URL
+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 +163,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 +202,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

@@ -6,7 +6,7 @@ const projectRoot = process.env.INIT_CWD || process.cwd();
 const mcpJsonPath = join(projectRoot, '.mcp.json');
 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"

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "food402",
-  "version": "1.0.4-beta.1",
+  "version": "1.1.0",
   "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>;