Demo Mcpserver

FastFoodMCP🚀

用于管理快餐系统数据的企业级MCP（Model Context Protocol）服务器 OAuth 2.1安全认证 mediante Scalekit。

📋 描述

FastFoodMCP是一台实现MCP协议的服务器，用于将Claude和其他AI工具与REST快餐管理API连接起来。它包括集成的OAUTH认证、范围验证和用于销售分析、用户和产品管理的专门工具。

主要特点：

• ✅ OAuth 2.1 与 Scalekit -安全身份验证和令牌验证
• ✅ 8+工具 -咨询和分析的专门职能
• ✅ 2提示 -执行报告和用户分析
• ✅ TypeScript -类型和安全代码
• ✅ 范围验证 -每个工具的粒度权限控制
• ✅ 鲁棒错误处理 -符合JSON-RPC 2.0的响应
• ✅ 高级测井 -温斯顿用于审计和调试

🏗️ 建筑

FastFoodMCP (MCP Server)
    ├── OAuth 2.1 (Scalekit)
    │   └── Validación de tokens y scopes
    │
    ├── Tools (Herramientas)
    │   ├── Users (get_users, create_user)
    │   ├── Products (get_products)
    │   ├── Branches (get_branches)
    │   ├── Clients (get_clients)
    │   ├── Orders (get_orders, get_orders_summary)
    │   └── Sales (get_tickets, get_tickets_summary, reportes por año)
    │
    ├── Prompts (Plantillas inteligentes)
    │   ├── Monthly Sales Report (Reporte ejecutivo)
    │   └── Users Report (Análisis de usuarios)
    │
    └── Backend API REST
        └── Validación con JWT + Scalekit OAuth

🛠️ 技术栈

• Node.js+Express HTTP 服务器
• TypeScript -类型安全
• MCP-SDK -Protocolo模型上下文协议
• Scalekit SDK -OAUTH认证
• 萨德 -方案验证
• 温斯顿 -测井专业人员
• 阿西奥斯 -REST API的HTTP客户端

🚀 快速启动

先决条件

• Node.js 18+
• npm o纱线
• 帐户 磅秤套件
• API REST功能和（后端）

安装

1. 克隆存储库

git clone https://github.com/tuusuario/FastFoodMCP.git
cd FastFoodMCP

1. 安装依赖项

npm install

1. 配置环境变量

cp .env.example .env

编辑 .env 使用您的ScaleKit凭据：

SK_ENV_URL=https://sta.scalekit.dev
SK_CLIENT_ID=tu_client_id
SK_CLIENT_SECRET=tu_client_secret
MCP_SERVER_ID=tu_mcp_server_id
BASE_URL=http://tu-ip-local
PORT=3003
BASE_URL_API=http://localhost:8080/api

1. 编译TypeScript

npm run build

1. 启动服务器

npm start

服务器将位于： http://localhost:3003

📡 OAUTH认证

该服务器需要使用ScaleKit进行OAuth 2.1身份验证。

认证流程

1. 客户端试图连接到MCP服务器
2. 服务器用401+header Oauth响应
3. 客户端在ScaleKit中打开浏览器进行登录
4. 用户身份验证
5. 令牌在标头中发送 Authorization: Bearer
6. 服务器验证令牌和作用域
7. 工具以验证的权限运行

支持的范围

• usr:read -阅读用户、产品、订单
• usr:write -创建新用户

与Claude Desktop的集成

与Claude Desktop一起使用：

1. Instala克劳德桌面
2. 打开 ~/.claude/claude_desktop_config.json （o） C:\Users\[tu-usuario]\AppData\Roaming\Claude\claude_desktop_config.json en Windows）
3. 添加您的MCP服务器：

{
  "mcpServers": {
    "fastfood": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3003/", "--allow-http"]
    }
  }
}

1. Abre Claude桌面
2. ScaleKit登录屏幕将自动打开
3. 经过认证后，您将能够使用所有工具

🔧 可用工具

用户

• 用户名 -列出所有带有可选过滤器（名称、电子邮件）的用户
• create_user -在系统中创建新用户

产品

• get_产品 -获取所有可用产品

分支/分支

• get_branches -列出所有分支

客户

• get_clients -列出带有过滤器的客户端

命令

• 获取订单 -使用高级过滤器查询订单（日期、分支、状态）
• get_orders_summary -按分支机构、用户、客户汇总订单

通风口/门票

• 获取门票 -带有多个过滤器的完整销售清单
• get_tickets_summary -使用Groupby进行快速比较的汇总分析
• 获取_牧场_销售_报告_年份 -年度月度销售报告
• 获取_分支_销售_报告_年份_类型 -按产品类型和月份划分的销售额
• 采购_销售_产品 -前10名畅销产品

📊 可用提示

月度销售报告

生成销售执行报告：

• 关键指标（收入、门票、平均门票）
• 前3-5名产品
• 与上月的比较分析
• 见解和建议
• 仪表板图形演示

用户报告

使用个性化过滤器的用户综合分析

🔐 安全

• ✅ 在每个请求中验证OAUTH令牌
• ✅ 每个工具的作用域验证
• ✅ 公共端点保护(.well-known)
• ✅ 通过安全处理机密 .env
• ✅ 验证 nbf （在此之前）索赔
• ✅ CORS控制配置
• ✅ 记录所有失败的身份验证

📦 项目结构

src/
├── config/          # Configuración (variables de entorno)
├── lib/
│   ├── auth.ts      # Handler OAuth
│   ├── middleware.ts # Middleware de autenticación
│   ├── logger.ts    # Configuración de logs
│   └── transport.ts # Setup de transporte MCP
├── services/        # Servicios que llaman a la API REST
├── tools/           # Definición de herramientas MCP
│   ├── users/
│   ├── products/
│   ├── branches/
│   ├── clients/
│   ├── orders/
│   └── sales/
├── prompts/         # Definición de prompts
│   └── sales/
└── server.ts        # Punto de entrada

🎯 使用案例

• 实时销售分析 -咨询趋势和顶级产品
• 执行报告 -为首席执行官生成自动报告
• 用户管理 -在系统中查询和创建用户
• 订单审计 -按期间检查购物历史
• 比较分析 -比较分支机构、用户和期间

📹 演示

您可以在这里看到服务器运行的完整演示：

• \[链接到演示视频\]（当您发布视频时将添加）

视频显示：

• VSCode中的初始设置
• 使用ScaleKit的Oauth流
• 执行8+工具
• 生成执行报告
• 实时数据分析

📖 API REST后端

该MCP服务器连接到REST API，该API实现：

• 双重认证：JWT+Cookie网页版，Scalekit MCP版
• 端点：用户、产品、分支机构、客户、订单、门票
• ScaleKit验证 在单独的中间件中
• 控制器和服务 Web和MCP之间共享

\[链接到REST API文档\]

🧪 测试

测试仍在进行中。

📝 日志

日志保存在 logs/ 带级别：信息，警告，错误

tail -f logs/app.log

🐛 故障排除

“丢失的承载令牌”

• 确保您已通过ScaleKit验证
• 清除浏览器缓存
• Reinicia Claude桌面

“令牌验证失败”

• 检查你 SK_CLIENT_SECRET 是正确的
• 检查你 MCP_SERVER_ID 在Scalekit中一致
• 检查URL是否位于 PROTECTED_RESOURCE_METADATA 这是正确的

“API服务器没有响应”

• 验证您的REST API是否正在运行 BASE_URL_API
• 检查URL .env

🤝 贡献

欢迎捐款。请：

1. 叉项目
2. 创建分支（git checkout -b feature/AmazingFeature)
3. 提交您的更改(git commit -m 'Add AmazingFeature')
4. 推拉拉马(git push origin feature/AmazingFeature)
5. 打开拉动请求

👤 作者

胡安·西蒙·拉迪诺·莫雷诺

• github：https://github.com/JuanLadinoMoreno
• 领英：https://www.linkedin.com/in/juansim%C3%B3nladino/

🙏 感谢

• 磅秤套件 通过Oauth平台
• Anthropic 通过MCP协议
• 克劳德 通过整合

______________________________________________________________________

创建于❤️ 胡安·拉迪诺