Toast MCP服务器
用于Toast餐厅POS和管理平台集成的完整模型上下文协议（MCP）服务器。
🚀 特性
10个类别的50多种工具
- 订单（12个工具） -完整的订单生命周期管理
- 获取、列出、创建、作废订单 - 按客户、业务日期搜索 - 添加/取消选择，应用折扣 - 更新承诺时间，跟踪状态
- 菜单（11个工具） -完整菜单和项目管理
- 列出/获取菜单、组、项目 - 搜索商品，更新价格 - 86管理层（缺货） - 批量操作
- 员工（9个工具） -员工管理
- 员工CRUD操作 - 岗位管理 - 搜索和过滤 - 时间输入跟踪
- 人工（6个工具） -劳动力分析
- 轮班管理 - 主动换档跟踪 - 劳工报告和总结 - 员工工时计算
- 餐厅（9工具） -配置和设置
- 餐厅信息和访问权限 - 桌子和服务区 - 餐饮选择、收入中心 - 在线订购和配送设置
- 付款（6种工具） -交易管理
- 支付CRUD操作 - 退款和无效 - 按类型列出的付款摘要
- 库存（5个工具） -库存管理
- 库存水平跟踪 - 低库存警报 - 数量更新 - 批量操作
- 客户（4工具） -客户关系管理
- 客户搜索和个人资料 - 订单历史 - 忠诚度计划集成 - 顶级客户分析
- 报告（6个工具） -分析和见解
- 销售总结 - 每小时细分 - 商品销售报告 - 付款类型、折扣和作废报告
- 现金（8工具） -现金管理
- 现金抽屉跟踪 - 实收/实收条目 - 存款记录 - 抽屉摘要
18个React应用程序（客户端UI）
订单和服务：
- 订单仪表板-实时监控
- 订单详情-深度订单检查
- 订单网格-多订单管理
- 表地图-视觉平面图
菜单管理：
- 菜单管理器-完整菜单编辑
- 菜单项详细信息-项目配置
- 菜单性能-销售分析
员工和劳工：
- 员工仪表板-员工目录
- 员工排班表-排班计划
- 劳动力仪表板-成本跟踪
- 提示摘要-收益分配
付款和财务：
- 付款历史记录-交易日志
- 销售仪表板-综合指标
- 按小时划分的收入-每小时分析
库存和运营：
- 库存跟踪器-库存管理
- 餐厅概述-系统配置
客户管理：
- 客户详细信息-档案和历史
- 客户忠诚度-奖励跟踪
📦 安装
npm install @busybee3333/toast-mcp-server或者克隆并在本地构建：
git clone https://github.com/BusyBee3333/mcpengine.git
cd mcpengine/servers/toast
npm install
npm run build🔧 配置
设置所需的环境变量：
export TOAST_CLIENT_ID="your_client_id"
export TOAST_CLIENT_SECRET="your_client_secret"
export TOAST_RESTAURANT_GUID="your_restaurant_guid" # Optional
export TOAST_ENVIRONMENT="production" # or "sandbox"🎯 用法
标准模式（MCP集成）
toast-mcp-server或者通过npx：
npx @busybee3333/toast-mcp-serverHTTP模式（Web UI+API）
TOAST_MCP_MODE=http TOAST_MCP_PORT=3000 toast-mcp-server访问UI： http://localhost:3000/apps/
Claude桌面集成
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"toast": {
"command": "npx",
"args": [
"@busybee3333/toast-mcp-server"
],
"env": {
"TOAST_CLIENT_ID": "your_client_id",
"TOAST_CLIENT_SECRET": "your_client_secret",
"TOAST_RESTAURANT_GUID": "your_restaurant_guid",
"TOAST_ENVIRONMENT": "production"
}
}
}
}🛠️ 工具示例
获取订单
{
"name": "toast_get_order",
"arguments": {
"orderGuid": "550e8400-e29b-41d4-a716-446655440000"
}
}列出业务日期订单
{
"name": "toast_list_orders",
"arguments": {
"businessDate": 20240215
}
}创建订单
{
"name": "toast_create_order",
"arguments": {
"source": "ONLINE",
"selections": [
{
"itemGuid": "item-123",
"quantity": 2
}
],
"customer": {
"firstName": "John",
"lastName": "Doe",
"phone": "+15551234567"
}
}
}标记项目86
{
"name": "toast_set_item_86",
"arguments": {
"itemGuid": "item-456",
"outOfStock": true
}
}获取销售摘要
{
"name": "toast_get_sales_summary",
"arguments": {
"businessDate": 20240215
}
}🏗️ 建筑
toast/
├── src/
│ ├── clients/
│ │ └── toast.ts # Toast API client with auth
│ ├── tools/
│ │ ├── orders.ts # 12 order tools
│ │ ├── menus.ts # 11 menu tools
│ │ ├── employees.ts # 9 employee tools
│ │ ├── labor.ts # 6 labor tools
│ │ ├── restaurant.ts # 9 restaurant tools
│ │ ├── payments.ts # 6 payment tools
│ │ ├── inventory.ts # 5 inventory tools
│ │ ├── customers.ts # 4 customer tools
│ │ ├── reporting.ts # 6 reporting tools
│ │ └── cash.ts # 8 cash tools
│ ├── types/
│ │ └── index.ts # Comprehensive TypeScript types
│ ├── ui/
│ │ └── react-app/ # 18 React apps (client-side)
│ ├── server.ts # MCP server implementation
│ └── main.ts # Entry point (stdio + HTTP)
├── package.json
├── tsconfig.json
└── README.md📊 API覆盖范围
此服务器实现了Toast API的全面覆盖：
- ✅ 订单API v2（完整CRUD）
- ✅ 菜单API v2（读取+更新）
- ✅ 劳动力API v1（员工、轮班、时间条目）
- ✅ 配置API v1（餐厅设置）
- ✅ 库存API v1（库存管理）
- ✅ 现金管理API v1
- ✅ 合作伙伴API v1（餐厅访问）
🔐 认证
使用OAuth 2.0客户端凭据流和自动令牌刷新。令牌由内部管理，并在到期前5分钟刷新。
🎨 UI 主题
所有18个应用程序都使用针对餐厅环境优化的一致深色主题：
- 背景
#0f0f0f - 卡：
#1a1a1a - 口音：
#00bfa5 - 文本：
#e0e0e0
🤝 贡献
欢迎投稿！请看主 mcpengine回购 关于贡献指南。
📄 许可证
麻省 理工© 忙碌的Bee3333
🔗 链接
🐛 已知问题
- HTTP模式工具执行尚未实现（对MCP使用stdio模式）
- UI应用程序当前使用客户端演示数据（连接到Toast API以获取实时数据）
🗓️ 路线图
- \[\]WebSocket支持实时订单更新
- \[\]完全HTTP模式实现
- \[\]其他报告端点
- \[\]厨房显示系统（KDS）集成
- \[\]多位置支持
______________________________________________________________________
内置于❤️ 餐饮业