Skip to content
Back to search

mcd-mcp-server

McDonald's China MCP Server Integration Guide

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/m-china--mcd-mcp-server/badge.svg)](/listings/m-china--mcd-mcp-server)

HTML

<a href="/listings/m-china--mcd-mcp-server"><img src="/api/listings/m-china--mcd-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 370 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://open.mcd.cn/mcp" target="_blank">
  3. <img src="https://img.mcd.cn/gallery/3fa1addc20b6d2d8.jpeg" align="middle" width = "1000" />
  4. </a>
  5. </p>
  6. <p align="center">
  7. 简体中文 | <a href="README_EN.md">English</a>
  8. </p>
  9. # 介绍
  10. **什么是麦当劳 MCP 服务?**
  11. - 麦当劳 MCP 服务是一个遵循 Model Context Protocol(MCP)标准的数据交互接口服务,由麦当劳中国提供,面向中国大陆地区(不含港澳台)使用。
  12. - 麦当劳MCP服务现已覆盖麦乐送点餐、到店取餐、团餐、积分兑换券、活动日历查询等业务场景。更多实用工具正在持续开发上线。
  13. - 麦当劳 MCP Server 开放平台官网:[https://open.mcd.cn/mcp](https://open.mcd.cn/mcp)
  14. # 1. 申请 MCP Token
  15. - 第一步:点击右上角【登录】按钮
  16. <div class="img"><img src="https://img.mcd.cn/gallery/91178777592c9118.jpeg" alt="" width="1000" /></div>
  17. - 第二步:跳转到登录页使用手机号验证登录
  18. <div class="img"><img src="https://img.mcd.cn/gallery/c7b5d9e9cdd2c786.png" alt="" width="1000" /></div>
  19. 登录成功后跳转回首页,“登录”按钮变成控制台
  20. <div class="img"><img src="https://img.mcd.cn/gallery/a854347bb1339ee1.jpeg" alt="" width="1000" /></div>
  21. - 第三步:申请 MCP Token\
  22. 点击右上角“控制台”后,会弹出控制台弹窗\
  23. 点击激活按钮,申请 MCP Token
  24. <div class="img"><img src="https://img.mcd.cn/gallery/37434d0289646b80.png" alt="" width="1000" /></div>
  25. - 第四步:同意服务协议
  26. <div class="img"><img src="https://img.mcd.cn/gallery/62916ae518d0876d.png" alt="" width="1000" /></div>
  27. - 第五步:MCP Token 申请成功,可以一键复制
  28. <div class="img"><img src="https://img.mcd.cn/gallery/3d14672fe32c8090.png" alt="" width="1000" /></div>
  29. # 2. 快速开始
  30. > 下面介绍如何将 MCP Server 接入到 MCP Client 中,开始使用 MCP 功能。\
  31. > 麦当劳中国提供了远程托管的 MCP Server,用户只需在 MCP Client 中配置接入地址和 MCP Token 即可使用。
  32. ## 2.1 接入地址
  33. > 服务器接入地址:`https://mcp.mcd.cn`
  34. ## 2.2 传输协议与安全
  35. > 使用 **Streamable HTTP** 协议接入\
  36. > 为了识别用户身份和权限,需要在请求头中携带 **Authorization** 字段,格式如下:
  37. ``` text
  38. Authorization: Bearer YOUR_MCP_TOKEN
  39. ```
  40. ## 2.3 MCP 配置 JSON 示例:
  41. > 为了方便使用,我们提供了JSON 配置示例。\
  42. > 复制下面的配置,替换 **YOUR_MCP_TOKEN** 为实际 MCP Token,粘贴到 MCP Client 的 MCP Server 配置中即可。
  43. ``` json
  44. {
  45. "mcpServers": {
  46. "mcd-mcp": {
  47. "type": "streamablehttp",
  48. "url": "https://mcp.mcd.cn",
  49. "headers": {
  50. "Authorization": "Bearer YOUR_MCP_TOKEN"
  51. }
  52. }
  53. }
  54. }
  55. ```
  56. ## 2.4 注意事项:
  57. > - 每个 Token 每分钟最多允许 600 次请求,超过限制会返回 429 错误码,请合理控制请求频率。
  58. > - 请确保 MCP Client 支持 Streamable HTTP 协议。
  59. > - 请妥善保管 MCP Token,避免泄露给他人。
  60. ## 2.5 MCP Client 推荐
  61. | Client | Link |
  62. |:-------------:|:--------------------------------------------------------------------:|
  63. | WorkBuddy | https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Connector |
  64. | Cherry Studio | https://docs.cherry-ai.com/advanced-basic/mcp |
  65. | Cursor | https://cursor.com/cn/docs/context/mcp#protocol-support |
  66. | Kiro | https://kiro.dev/docs/mcp/ |
  67. | Trae | https://docs.trae.cn/ide/model-context-protocol |
  68. | VSCode | https://code.visualstudio.com/docs/copilot/customization/mcp-servers |
  69. ## 2.6 各平台接入教程:
  70. ### 2.6.1 Cherry Studio
  71. > **前置条件**:需申请到麦当劳中国的 MCP Token,教程:[申请 MCP Token](#1-申请-mcp-token)\
  72. > 参考 Cherry Studio 官方文档:https://docs.cherry-ai.com/advanced-basic/mcp
  73. 1、 打开 Cherry Studio,进入设置页面\
  74. 2、 选择“MCP”选项卡\
  75. 3、 点击“添加”按钮\
  76. 4、 在弹出的下拉框中,选择“从 JSON 导入”
  77. <div class="img"><img src="https://img.mcd.cn/gallery/662175d6e573bb31.png" alt="" width="1000" /></div>
  78. 从上面复制JSON粘贴进去, **一定记得替换 “YOUR_MCP_TOKEN”**,然后点击“确定”按钮
  79. <div class="img"><img src="https://img.mcd.cn/gallery/932b5bea7c9a79eb.png" alt="" width="1000" /></div>
  80. 添加完成后,请打开启用开关
  81. <div class="img"><img src="https://img.mcd.cn/gallery/ade1966003d77e3b.png" alt="" width="1000" /></div>
  82. 配置完成。现在可以在聊天窗口中使用 MCP 功能。
  83. <div class="img"><img src="https://img.mcd.cn/gallery/16721f738e7f631e.png" alt="" width="1000" /></div>
  84. ### 2.6.2 Cursor
  85. > 前置条件:需申请到麦当劳中国的 MCP Token,教程:[申请 MCP Token](#1-申请-mcp-token)\
  86. > 参考 Cursor 官方文档:https://cursor.com/cn/docs/context/mcp
  87. 打开 Cursor,点击顶部菜单栏【设置】→【Tools & MCP】,在 Installed MCP Servers 中点击【Add Custom MCP】
  88. <div class="img"><img src="https://img.mcd.cn/gallery/b4817eeb8c597384.png" alt="" width="1000" /></div>
  89. 在打开的 mcp.json 文件中填入从上面复制的JSON内容,一定记得替换 YOUR_MCP_TOKEN 为实际 MCP Token,点击【关闭】并选择【保存】
  90. <div class="img"><img src="https://img.mcd.cn/gallery/671f20806476f7f7.png" alt="" width="1000" /></div>
  91. 回到设置页面中,此时应显示可用的麦当劳mcp工具,服务状态应显示为【已连接】
  92. <div class="img"><img src="https://img.mcd.cn/gallery/75a3dabf77fac237.png" alt="" width="1000" /></div>
  93. 按下 CTRL/CMD + L 打开右侧 Agent 对话框,接下来就可以直接在对话框中输入需求,让 AI 为我们调用工具了
  94. <div class="img"><img src="https://img.mcd.cn/gallery/fed973ae04371908.png" alt="" width="1000" /></div>
  95. ### 2.6.3 TRAE
  96. > 前置条件:需申请到麦当劳中国的 MCP Token,教程:[申请 MCP Token](#1-申请-mcp-token)\
  97. > 参考 TRAE 官方文档:https://docs.trae.cn/ide/model-context-protocol
  98. 打开 Trae,点击【设置】→【MCP】→ 【手动添加】进行添加
  99. <div class="img"><img src="https://img.mcd.cn/gallery/1b29297767cc5458.png" alt="" width="1000" /></div>
  100. <div class="img"><img src="https://img.mcd.cn/gallery/720beadfcd8c7573.png" alt="" width="1000" /></div>
  101. 在打开的手动配置页面中填入从上面复制的JSON内容,一定记得替换YOUR_MCP_TOKEN 为实际 MCP Token,点击【确认】
  102. <div class="img"><img src="https://img.mcd.cn/gallery/a532f0555f6d0497.png" alt="" width="1000" /></div>
  103. 回到MCP页面中,此时应显示可用的麦当劳mcp工具,服务状态应显示为【已连接】
  104. <div class="img"><img src="https://img.mcd.cn/gallery/abe84f630677bfd7.png" alt="" width="1000" /></div>
  105. 回到对话框中 ,选择【Builder with MCP】
  106. <div class="img"><img src="https://img.mcd.cn/gallery/32970b601e173816.png" alt="" width="1000" /></div>
  107. <div class="img"><img src="https://img.mcd.cn/gallery/68c6f494dfda0627.png" alt="" width="1000" /></div>
  108. 接下来就可以直接在对话框中输入需求,让 AI 为我们调用工具了
  109. <div class="img"><img src="https://img.mcd.cn/gallery/4b82125a6902a916.png" alt="" width="1000" /></div>
  110. ## 2.7 错误码说明
  111. | code | 原因 | 处理建议 |
  112. |:----:|:----:|:---------|
  113. | 401 | MCP Token 无效、已过期或未提供 | 检查 Authorization 请求头和 MCP Token 配置 |
  114. | 429 | 触发限流(超过 600 次/分钟) | 降低请求频率,合理控制调用间隔 |
  115. # 3. 工具列表
  116. > MCP Server 目前所支持的 Tools
  117. <table>
  118. <thead>
  119. <tr>
  120. <th style="white-space: nowrap; text-align: center;"><strong>Tool</strong></th>
  121. <th style="min-width: 100px;"><strong>Name</strong></th>
  122. <th><strong>Description</strong></th>
  123. </tr>
  124. </thead>
  125. <tbody>
  126. <tr>
  127. <td style="white-space: nowrap; text-align: center;">list-nutrition-foods</td>
  128. <td>餐品营养信息列表</td>
  129. <td>获取麦当劳常见餐品的营养成分数据,包括能量、蛋白质、脂肪、碳水化合物、钠、钙等信息。当用户咨询麦当劳餐品的热量、营养,或需要帮助用户搭配指定热量套餐时使用此工具</td>
  130. </tr>
  131. <tr>
  132. <td style="white-space: nowrap; text-align: center;">delivery-query-addresses</td>
  133. <td>获取用户可配送地址列表</td>
  134. <td>查询用户已创建的配送地址列表,用于外送点餐时选择配送地址</td>
  135. </tr>
  136. <tr>
  137. <td style="white-space: nowrap; text-align: center;">delivery-create-address</td>
  138. <td>新增配送地址</td>
  139. <td>当用户无可配送地址或需新增收货地址时使用,用于创建新的可配送地址</td>
  140. </tr>
  141. <tr>
  142. <td style="white-space: nowrap; text-align: center;">delivery-query-stores</td>
  143. <td>查询可配送的门店列表</td>
  144. <td>外送场景下查询用户收货地址附近可配送门店</td>
  145. </tr>
  146. <tr>
  147. <td style="white-space: nowrap; text-align: center;">query-meal-assistance</td>
  148. <td>查询助餐服务</td>
  149. <td>仅企业团餐场景下,查询该门店支持的助餐服务</td>
  150. </tr>
  151. <tr>
  152. <td style="white-space: nowrap; text-align: center;">query-nearby-stores</td>
  153. <td>查询附近可用门店</td>
  154. <td>查询用户提供地址附近的麦当劳餐厅</td>
  155. </tr>
  156. <tr>
  157. <td style="white-space: nowrap; text-align: center;">query-store-coupons</td>
  158. <td>查询用户当前门店下可用的优惠券列表</td>
  159. <td>查询用户在当前门店下可使用的优惠券列表,用于点餐时选择可用优惠</td>
  160. </tr>
  161. <tr>
  162. <td style="white-space: nowrap; text-align: center;">query-meals</td>
  163. <td>查询当前可售卖的餐品列表</td>
  164. <td>查询当前门店可售卖的餐品菜单(分类、餐品编码、标签等),用于点餐选品</td>
  165. </tr>
  166. <tr>
  167. <td style="white-space: nowrap; text-align: center;">query-meal-detail</td>
  168. <td>查询餐品详情</td>
  169. <td>根据餐品编码查询餐品详情套餐组成,用于查看套餐包含内容以及可以替换选项</td>
  170. </tr>
  171. <tr>
  172. <td style="white-space: nowrap; text-align: center;">calculate-price</td>
  173. <td>商品价格计算</td>
  174. <td>根据用户选购商品列表(可含优惠券)计算商品金额、配送费、优惠金额及应付总价</td>
  175. </tr>
  176. <tr>
  177. <td style="white-space: nowrap; text-align: center;">create-order</td>
  178. <td>创建订单</td>
  179. <td>根据门店信息、就餐方式、商品列表等信息创建订单,返回订单详情与支付链接</td>
  180. </tr>
  181. <tr>
  182. <td style="white-space: nowrap; text-align: center;">cancel-order</td>
  183. <td>取消订单</td>
  184. <td>取消点餐订单。当用户说&quot;取消订单&quot;、&quot;我要取消&quot;、&quot;帮我取消一下订单&quot;时,可使用该工具进行取消</td>
  185. </tr>
  186. <tr>
  187. <td style="white-space: nowrap; text-align: center;">query-order</td>
  188. <td>查询订单详情</td>
  189. <td>查询订单状态、订单内容、配送信息等,用于用户查看订单进度或确认订单信息</td>
  190. </tr>
  191. <tr>
  192. <td style="white-space: nowrap; text-align: center;">order-list</td>
  193. <td>查询历史订单</td>
  194. <td>查询近期的到店/外送历史订单(非商城订单,商城订单请使用 mall-order-list)</td>
  195. </tr>
  196. <tr>
  197. <td style="white-space: nowrap; text-align: center;">campaign-calendar</td>
  198. <td>活动日历查询工具</td>
  199. <td>查询麦当劳中国当月的营销活动日历,返回进行中、往期和未来日期的活动</td>
  200. </tr>
  201. <tr>
  202. <td style="white-space: nowrap; text-align: center;">available-coupons</td>
  203. <td>麦麦省券列表查询</td>
  204. <td>查询用户当前可领取的麦麦省的优惠券列表</td>
  205. </tr>
  206. <tr>
  207. <td style="white-space: nowrap; text-align: center;">auto-bind-coupons</td>
  208. <td>麦麦省一键领券</td>
  209. <td>自动领取麦麦省所有当前可用的麦当劳优惠券。无需指定具体的优惠券和couponId,系统会自动领取用户可领的所有券</td>
  210. </tr>
  211. <tr>
  212. <td style="white-space: nowrap; text-align: center;">query-my-coupons</td>
  213. <td>我的优惠券查询</td>
  214. <td>查询用户有哪些可用的优惠券。支持用户查看账户下所有优惠券列表</td>
  215. </tr>
  216. <tr>
  217. <td style="white-space: nowrap; text-align: center;">query-my-account</td>
  218. <td>我的积分查询</td>
  219. <td>查询用户积分账户信息,包括可用积分、累计积分、冻结积分、即将过期积分等</td>
  220. </tr>
  221. <tr>
  222. <td style="white-space: nowrap; text-align: center;">mall-points-products</td>
  223. <td>查询麦麦商城商品列表</td>
  224. <td>查询麦麦商城内可使用积分兑换或现金购买的商品(不包括使用积分兑换的第三方兑换码)</td>
  225. </tr>
  226. <tr>
  227. <td style="white-space: nowrap; text-align: center;">mall-product-detail</td>
  228. <td>查询麦麦商城商品详情</td>
  229. <td>查询商城商品详细信息(图片、积分、有效期、说明、详情等)</td>
  230. </tr>
  231. <tr>
  232. <td style="white-space: nowrap; text-align: center;">mall-create-order</td>
  233. <td>积分兑换商品下单</td>
  234. <td>使用积分兑换虚拟或实物商品,完成积分校验、积分扣减及发券或实物库存扣减,返回兑换订单号和券码信息</td>
  235. </tr>
  236. <tr>
  237. <td style="white-space: nowrap; text-align: center;">now-time-info</td>
  238. <td>获取当前时间信息</td>
  239. <td>返回当前的完整时间信息,以便于 LLM 知道当前的时间和日期</td>
  240. </tr>
  241. <tr>
  242. <td style="white-space: nowrap; text-align: center;">query-lottery-info</td>
  243. <td>查看积分抽奖活动信息</td>
  244. <td>查询当前积分抽奖活动的基本信息,包括活动状态、奖品列表、抽奖消耗规则和用户可用资源</td>
  245. </tr>
  246. <tr>
  247. <td style="white-space: nowrap; text-align: center;">draw-lottery</td>
  248. <td>积分抽奖</td>
  249. <td>执行一次积分抽奖,消耗积分或次数,返回是否中奖及奖品信息</td>
  250. </tr>
  251. <tr>
  252. <td style="white-space: nowrap; text-align: center;">query-my-prizes</td>
  253. <td>查看我的奖品</td>
  254. <td>查询用户在积分抽奖活动中获得的全部奖品记录,支持分页,按中奖时间倒序排列</td>
  255. </tr>
  256. <tr>
  257. <td style="white-space: nowrap; text-align: center;">mall-order-list</td>
  258. <td>麦麦商城订单查询</td>
  259. <td>查询麦麦商城内近一年购买或兑换的商品订单列表</td>
  260. </tr>
  261. <tr>
  262. <td style="white-space: nowrap; text-align: center;">mall-order-detail</td>
  263. <td>麦麦商城订单详情查询</td>
  264. <td>查询麦麦商城订单的详细信息,包括支付积分、支付金额和订单状态等</td>
  265. </tr>
  266. <tr>
  267. <td style="white-space: nowrap; text-align: center;">query-party-city</td>
  268. <td>主题活动城市列表查询</td>
  269. <td>查询主题活动商品对应的可参与城市列表</td>
  270. </tr>
  271. <tr>
  272. <td style="white-space: nowrap; text-align: center;">query-party-store</td>
  273. <td>主题活动门店列表查询</td>
  274. <td>查询指定城市下主题活动可参与的门店列表</td>
  275. </tr>
  276. <tr>
  277. <td style="white-space: nowrap; text-align: center;">query-partystore-date</td>
  278. <td>主题活动可预约日期查询</td>
  279. <td>查询指定门店下主题活动的可预约日期列表</td>
  280. </tr>
  281. <tr>
  282. <td style="white-space: nowrap; text-align: center;">query-partystore-session</td>
  283. <td>主题活动可预约日期场次查询</td>
  284. <td>查询指定门店、指定日期下主题活动的可预约场次列表</td>
  285. </tr>
  286. <tr>
  287. <td style="white-space: nowrap; text-align: center;">party-order-create</td>
  288. <td>主题活动订单创建</td>
  289. <td>创建主题活动订单,当用户选择好城市、门店、日期、场次后使用此工具下单</td>
  290. </tr>
  291. </tbody>
  292. </table>
  293. # 4. 版本日志
  294. | Date | Version | Description |
  295. |:----------:|:-------:|-------------------------------------|
  296. | 2025-12-09 | 1.0.0 | 麦麦日历和麦麦省领券 MCP Server |
  297. | 2026-01-23 | 1.0.1 | 增加了“餐品营养信息列表”Tool,我们缩短了 URL 以便于大家连接 |
  298. | 2026-02-13 | 1.0.2 | 增加了麦乐送点餐与积分兑换券场景的Tools |
  299. | 2026-04-02 | 1.0.3 | 增加了到店取餐与团餐场景的Tools |
  300. | 2026-05-21 | 1.0.4 | 增加了积分兑换实物、商城订单查询等 Tools,并支持得来速车道取餐场景下单及全部点餐场景预约功能 |
  301. | 2026-06-16 | 1.0.5 | 支持更换套餐内商品组合、部分餐品特制 |
  302. | 2026-07-16 | 1.0.6 | 新增历史订单查询工具;支持展示餐品优惠价格;支持随单购买麦金卡和早餐卡 |
  303. | 2026-07-29 | 1.0.7 | 新增麦当劳派对、品鉴会等主题活动查询、预约与下单功能 |
  304. | 2026-08-27 | 1.0.8 | 新增积分抽奖工具:查看活动信息、抽奖、查我的奖品 |
  305. | 2026-09-10 | 1.0.9 | 新增取消订单、餐具选择、麦乐送订单备注功能;堂食外带场景下支持返回取餐柜二维码 |
  306. ---
  307. # 5. 注意事项:
  308. - 允许个人以非商业用途复制并使用本仓库中的示例配置、参数、JSON 或示例代码,并仅限用于实现与麦当劳MCP服务的连接与使用。
  309. - 使用 麦当劳MCP 服务须遵守麦当劳中国的《使用条款》及《麦当劳MCP 服务规则》,并在申请MCP Token时同意前述条款。
  310. - 未经书面授权,不得将本仓库内容用于商业售卖、付费分发、引流变现或任何暗示官方背书、误导公众的用途;亦不得用于任何违法、违规或黑灰产相关行为。
  311. - 本仓库内容按“现状”提供,不构成任何形式的保证或承诺。
  312. - 本仓库不构成对麦当劳及其关联方商标的任何授权。
  313. - 请妥善保管您的MCP Token,避免泄露或被他人使用。
  314. <p align="center">© 2026 McDonald’s. All Rights Reserved.</p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.