About Mcd MCP Server
Mcd MCP Server is an MCP server published by M-China in the Developer Tools category: mcDonald's China MCP Server Integration Guide.
The repository has 215 stars and 8 forks, with the last commit 16 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/M-China/mcd-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Mcd MCP Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 3 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
1 check has not been run yet.
Releases
README
介绍
什么是麦当劳 MCP 服务?
- 麦当劳 MCP 服务是一个遵循 Model Context Protocol(MCP)标准的数据交互接口服务,由麦当劳中国提供,面向中国大陆地区(不含港澳台)使用。
- 麦当劳MCP服务现已覆盖麦乐送点餐、到店取餐、团餐、积分兑换券、活动日历查询等业务场景。更多实用工具正在持续开发上线。
- 麦当劳 MCP Server 开放平台官网:https://open.mcd.cn/mcp
1. 申请 MCP Token
- 第一步:点击右上角【登录】按钮
- 第二步:跳转到登录页使用手机号验证登录
- 第三步:申请 MCP Token
点击右上角“控制台”后,会弹出控制台弹窗
点击激活按钮,申请 MCP Token - 第四步:同意服务协议
- 第五步:MCP Token 申请成功,可以一键复制
2. 快速开始
下面介绍如何将 MCP Server 接入到 MCP Client 中,开始使用 MCP 功能。
麦当劳中国提供了远程托管的 MCP Server,用户只需在 MCP Client 中配置接入地址和 MCP Token 即可使用。
2.1 接入地址
服务器接入地址:
https://mcp.mcd.cn
2.2 传输协议与安全
使用 Streamable HTTP 协议接入
为了识别用户身份和权限,需要在请求头中携带 Authorization 字段,格式如下:
Authorization: Bearer YOUR_MCP_TOKEN
2.3 MCP 配置 JSON 示例:
为了方便使用,我们提供了JSON 配置示例。
复制下面的配置,替换 YOUR_MCP_TOKEN 为实际 MCP Token,粘贴到 MCP Client 的 MCP Server 配置中即可。
{
"mcpServers": {
"mcd-mcp": {
"type": "streamablehttp",
"url": "https://mcp.mcd.cn",
"headers": {
"Authorization": "Bearer YOUR_MCP_TOKEN"
}
}
}
}
2.4 注意事项:
- 每个 Token 每分钟最多允许 600 次请求,超过限制会返回 429 错误码,请合理控制请求频率。
- 请确保 MCP Client 支持 Streamable HTTP 协议。
- 请妥善保管 MCP Token,避免泄露给他人。
2.5 MCP Client 推荐
2.6 各平台接入教程:
2.6.1 Cherry Studio
前置条件:需申请到麦当劳中国的 MCP Token,教程:申请 MCP Token
参考 Cherry Studio 官方文档:https://docs.cherry-ai.com/advanced-basic/mcp
1、 打开 Cherry Studio,进入设置页面
2、 选择“MCP”选项卡
3、 点击“添加”按钮
4、 在弹出的下拉框中,选择“从 JSON 导入”
从上面复制JSON粘贴进去, 一定记得替换 “YOUR_MCP_TOKEN”,然后点击“确定”按钮
添加完成后,请打开启用开关
配置完成。现在可以在聊天窗口中使用 MCP 功能。
2.6.2 Cursor
前置条件:需申请到麦当劳中国的 MCP Token,教程:申请 MCP Token
参考 Cursor 官方文档:https://cursor.com/cn/docs/context/mcp
打开 Cursor,点击顶部菜单栏【设置】→【Tools & MCP】,在 Installed MCP Servers 中点击【Add Custom MCP】
在打开的 mcp.json 文件中填入从上面复制的JSON内容,一定记得替换 YOUR_MCP_TOKEN 为实际 MCP Token,点击【关闭】并选择【保存】
回到设置页面中,此时应显示可用的麦当劳mcp工具,服务状态应显示为【已连接】
按下 CTRL/CMD + L 打开右侧 Agent 对话框,接下来就可以直接在对话框中输入需求,让 AI 为我们调用工具了
2.6.3 TRAE
前置条件:需申请到麦当劳中国的 MCP Token,教程:申请 MCP Token
参考 TRAE 官方文档:https://docs.trae.cn/ide/model-context-protocol
打开 Trae,点击【设置】→【MCP】→ 【手动添加】进行添加
在打开的手动配置页面中填入从上面复制的JSON内容,一定记得替换YOUR_MCP_TOKEN 为实际 MCP Token,点击【确认】
回到MCP页面中,此时应显示可用的麦当劳mcp工具,服务状态应显示为【已连接】
回到对话框中 ,选择【Builder with MCP】
接下来就可以直接在对话框中输入需求,让 AI 为我们调用工具了
2.7 错误码说明
| code | 原因 | 处理建议 |
|---|---|---|
| 401 | MCP Token 无效、已过期或未提供 | 检查 Authorization 请求头和 MCP Token 配置 |
| 429 | 触发限流(超过 600 次/分钟) | 降低请求频率,合理控制调用间隔 |
3. 工具列表
MCP Server 目前所支持的 Tools
4. 版本日志
| Date | Version | Description |
|---|---|---|
| 2025-12-09 | 1.0.0 | 麦麦日历和麦麦省领券 MCP Server |
| 2026-01-23 | 1.0.1 | 增加了“餐品营养信息列表”Tool,我们缩短了 URL 以便于大家连接 |
| 2026-02-13 | 1.0.2 | 增加了麦乐送点餐与积分兑换券场景的Tools |
| 2026-04-02 | 1.0.3 | 增加了到店取餐与团餐场景的Tools |
| 2026-05-21 | 1.0.4 | 增加了积分兑换实物、商城订单查询等 Tools,并支持得来速车道取餐场景下单及全部点餐场景预约功能 |
| 2026-06-16 | 1.0.5 | 支持更换套餐内商品组合、部分餐品特制 |
| 2026-07-16 | 1.0.6 | 新增历史订单查询工具;支持展示餐品优惠价格;支持随单购买麦金卡和早餐卡 |
| 2026-07-29 | 1.0.7 | 新增麦当劳派对、品鉴会等主题活动查询、预约与下单功能 |
| 2026-08-27 | 1.0.8 | 新增积分抽奖工具:查看活动信息、抽奖、查我的奖品 |
| 2026-09-10 | 1.0.9 | 新增取消订单、餐具选择、麦乐送订单备注功能;堂食外带场景下支持返回取餐柜二维码 |
5. 注意事项:
-
允许个人以非商业用途复制并使用本仓库中的示例配置、参数、JSON 或示例代码,并仅限用于实现与麦当劳MCP服务的连接与使用。
-
使用 麦当劳MCP 服务须遵守麦当劳中国的《使用条款》及《麦当劳MCP 服务规则》,并在申请MCP Token时同意前述条款。
-
未经书面授权,不得将本仓库内容用于商业售卖、付费分发、引流变现或任何暗示官方背书、误导公众的用途;亦不得用于任何违法、违规或黑灰产相关行为。
-
本仓库内容按“现状”提供,不构成任何形式的保证或承诺。
-
本仓库不构成对麦当劳及其关联方商标的任何授权。
-
请妥善保管您的MCP Token,避免泄露或被他人使用。
README fetched from the repository 3 hours ago. The original is authoritative.