mcd-mcp-app 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +55 -0
- package/dist/index.html +270 -0
- package/dist/server.js +478 -0
- package/package.json +50 -0
package/README.md
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# 🍔 McDonald's MCP App (麦当劳 MCP 应用)
|
|
2
|
+
|
|
3
|
+
> ⚠️ **免责声明**: 本项目仅供学习和技术研究使用，请勿用于任何商业用途。
|
|
4
|
+
|
|
5
|
+
这是一个基于 **Model Context Protocol (MCP)** 标准构建的应用程序，专为麦当劳中国用户设计的 **MCP App**，结合了后端逻辑与 **React** 前端界面，为您提供直观、可视化的交互体验。
|
|
6
|
+
|
|
7
|
+
通过本应用，您可以在支持 MCP App的 AI 助手中，直接通过对话查询麦当劳活动、浏览优惠券，并享受一键领券的便捷服务。
|
|
8
|
+
|
|
9
|
+
## ✨ 核心功能
|
|
10
|
+
|
|
11
|
+
本应用通过 MCP 协议向 AI 助手暴露了以下能力，并为每个功能提供了配套的 UI 界面：
|
|
12
|
+
|
|
13
|
+
- **📅 活动日历 (`campaign-calender`)**
|
|
14
|
+
- 查询当月营销活动（进行中、往期、未来）。
|
|
15
|
+
- **UI 展示**: 交互式日历视图，清晰展示每日活动详情。
|
|
16
|
+
<div style="display: flex; gap: 10px;">
|
|
17
|
+
<img src="./screenshot/event-calendar.png" width="260" alt="活动日历预览" />
|
|
18
|
+
<img src="./screenshot/event-list.png" width="260" alt="活动列表预览" />
|
|
19
|
+
<img src="./screenshot/event-info.png" width="260" alt="活动详情预览" />
|
|
20
|
+
</div>
|
|
21
|
+
|
|
22
|
+
- **🎫 麦麦省券列表 (`available-coupons`)**
|
|
23
|
+
- 实时查询当前可领取的优惠券列表。
|
|
24
|
+
- **UI 展示**: 图文并茂的优惠券卡片，展示券面、状态及促销标签。
|
|
25
|
+
<img src="./screenshot/coupons.png" width="600" alt="优惠券列表预览" />
|
|
26
|
+
|
|
27
|
+
- **🤖 一键领券 (`auto-bind-coupons`)**
|
|
28
|
+
- 自动批量领取所有可用的麦麦省优惠券。
|
|
29
|
+
- **UI 展示**: 领券结果汇总，展示成功领取数量及详情。
|
|
30
|
+
|
|
31
|
+
- **💰 我的优惠券**
|
|
32
|
+
- 查看已拥有的优惠券资产 (UI 界面支持)。
|
|
33
|
+
<img src="./screenshot/my-coupons.png" width="600" alt="我的优惠券预览" />
|
|
34
|
+
|
|
35
|
+
### Use in MCP Client (e.g. Claude Desktop)
|
|
36
|
+
|
|
37
|
+
Add the following configuration to your MCP client config file (e.g., `claude_desktop_config.json`):
|
|
38
|
+
|
|
39
|
+
```json
|
|
40
|
+
{
|
|
41
|
+
"mcpServers": {
|
|
42
|
+
"mcd-mcp-app": {
|
|
43
|
+
"command": "npx",
|
|
44
|
+
"args": ["-y", "mcd-mcp-app"],
|
|
45
|
+
"env": {
|
|
46
|
+
"Authorization": "your_mcdonalds_token"
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
**Enjoy your McDonald's treats with AI! 🍟🍦**
|