foodpanda mcp
MCP服务器允许AI助手从 foodpanda.ph 代表你。
告诉你的人工智能助手你想吃什么,它就会处理剩下的事情——搜索餐馆、浏览菜单、构建购物车,以及通过你的foodpanda帐户下订单。
特性
- 按送货地址附近的餐厅名称或菜肴搜索餐厅
- 浏览包含价格、描述和自定义选项的完整菜单
- 使用foodpanda的实时价格验证构建购物车
- 两步结账,订单预览和明确确认
- 货到付款结账(信用卡和GCash需要基于浏览器的支付流程,不受支持)
- 通过浏览器登录自动刷新令牌(不再从DevTools复制令牌)
快速开始
1.获取您的交货坐标
获取您的送货地址的纬度和经度(右键单击 谷歌地图 → 复制坐标)。
注: 您不再需要手动复制会话令牌。这 refresh_token 该工具通过打开浏览器窗口进行登录来处理身份验证。2.配置您的MCP客户端
克劳德桌面版
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"foodpanda": {
"command": "npx",
"args": ["-y", "foodpanda-mcp"],
"env": {
"FOODPANDA_LATITUDE": "14.5623",
"FOODPANDA_LONGITUDE": "121.0137"
}
}
}
}其他MCP客户端
任何支持stdio传输的MCP兼容客户端都可以工作。设置两个坐标环境变量并运行 npx foodpanda-mcp首次使用时,AI会打开一个浏览器让你登录foodpanda。
3.试试看
问你的AI助手:
“搜索我附近的Jollibee,并向我展示他们的菜单”
“将1只Chickjoy添加到我的购物车”
“预览我的订单,让我在下单前确认”
可用工具
| 工具 | 说明 |
|---|---|
search_restaurants | 按餐厅名称或菜肴搜索餐厅 |
get_restaurant_details | 获取餐厅信息(营业时间、配送费、最低订单) |
get_menu | 浏览按类别组织的餐厅菜单 |
get_item_details | 获取完整的商品详细信息,包括配料/定制选项 |
add_to_cart | 将商品添加到购物车(使用foodpanda验证价格) |
get_cart | 查看当前购物车内容和总数 |
remove_from_cart | 从购物车中删除商品 |
preview_order | 预览订单摘要,包括送货地址和付款方式 |
place_order | 用户确认后下单 |
refresh_token | 打开浏览器登录并刷新会话令牌 |
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
FOODPANDA_SESSION_TOKEN | 否 | JWT承载令牌(可选--使用 refresh_token 工具代替) |
FOODPANDA_LATITUDE | 是 | 您的送货地址纬度 |
FOODPANDA_LONGITUDE | 是 | 您的送货地址的经度 |
订单安全
结账流程设计为 人在循环 图案:
preview_order显示完整的订单摘要(项目、总计、交货地址、付款方式)- AI被指示 始终向您展示此内容并要求确认
place_order仅在您明确批准后执行
这可以防止意外订单——人工智能不能跳过确认步骤。
运作原理
- 搜索 将foodpandada的GraphQL API与Apollo持久化查询一起使用
- 餐厅详情和菜单 在上使用REST API
/api/v5/vendors/{code} - 购物车 在foodpanda端是无状态的——此服务器在内存中维护购物车状态,并将完整的购物车发送到
/api/v5/cart/calculate用于对每次更改进行价格验证 - 结账 获取您保存的地址和付款方式,然后提交给
/api/v5/cart/checkout - 价格单位为PHP(菲律宾比索)
从源头构建
git clone https://github.com/johnwhoyou/foodpanda-mcp.git
cd foodpanda-mcp
npm install # also installs Google Chrome via postinstall
npm run build然后在MCP客户端配置中使用本地构建:
{
"mcpServers": {
"foodpanda": {
"command": "node",
"args": ["/absolute/path/to/foodpanda-mcp/build/index.js"],
"env": {
"FOODPANDA_LATITUDE": "14.5623",
"FOODPANDA_LONGITUDE": "121.0137"
}
}
}
}代理技能
该项目包括 代理技能 在 foodpanda-ordering/SKILL.md 它教会了人工智能代理从搜索餐馆到下订单的完整订购工作流程。如果您的代理支持代理技能格式,它可以使用此技能通过MCP服务器自主订购食物。
局限性
- 会话令牌过期。 这
refresh_token这个工具会自动处理这个问题——人工智能会打开一个浏览器,让你在需要时登录。 - 没有官方API。 这个服务器反向引擎的食物熊猫的内部网页API。如果食物熊猫改变API,它可能会破裂。
- 只有菲律宾。 专门针对foodpanda.ph。其他区域使用不同的API端点,可能无法工作。
- 付款方式。 仅支持货到付款。信用卡和GCash需要基于浏览器的支付流(Adyen SDK/app重定向),无法通过API调用完成。看 #2.
- 单一收货地址。 使用最接近配置坐标的保存地址。
