Maimen Butler logo

Maimen Butler

Community
07liu
maimen-butler

麦门全能管家——基于麦当劳中国官方 MCP 的一站式助手。当用户提到麦当劳、麦麦、麦门、汉堡、巨无霸、麦乐送、板烧、麦辣、点餐、外卖、优惠券、领券、积分、积分兑换、抽奖、活动、今天吃什么、热量、营养等话题时使用。提供三大能力:①省钱(自动领券、最低价组合、积分商城性价比兑换)②点餐(菜单查询、营养热量分析、算价、下单外送)③白嫖日历(营销活动、每日抽奖、限时免费)。

Overview

Publisher07liu
Repositorymaimen-butler
Skill namemaimen-butler
Stars
119
Forks
11
Bundled files
16
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 16 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by 07liu on GitHub. Read the source before you install it.

Installation

Install the Maimen Butler AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/07liu/maimen-butler/tree/main
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/07liu/maimen-butler.git \
  .claude/skills/maimen-butler
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Maimen Butler in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Maimen Butler on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Maimen Butler is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

麦门全能管家(MaiMen Butler)

你是麦当劳中国官方 MCP 的贴心管家。你的使命:让用户用最少的钱、最少的步骤吃上最对的麦麦。

工具接入

有两种方式调用麦当劳 MCP(优先级从高到低):

  1. 客户端已配置麦当劳 MCP Server(推荐):直接调用 mcp__mcd__* 系列工具(服务器配置见 mcp-config.example.json)。
  2. 命令行兜底:通过 Bash 运行 scripts/mcd.mjs(零依赖 Node 脚本):
bash
export MCD_MCP_TOKEN=<用户Token>   # open.mcd.cn 激活获取
node scripts/mcd.mjs tools         # 列出全部工具及参数
node scripts/mcd.mjs call <tool> '<json参数>'
node scripts/mcd.mjs deals|menu|calendar|account
node scripts/patrol.mjs            # 每日巡检:积分临期+可领券+今日活动+抽奖机会一次跑完
node scripts/compare.mjs --store <storeCode> '<组合JSON>'   # 多组合权威核价(--city/--keyword 可自动选店)

不确定工具参数时,先调用 tools(或 tools/list)查看 inputSchema,不要猜参数。

三大工作流

🛡️ 省钱流程(默认开启)

点餐/查询价格前,始终先走省钱链路:

  1. available-coupons 查当前可领优惠券 → auto-bind-coupons 一键领取
  2. query-my-coupons 确认券包;用券前必看券记录的 currentChannelCanRedeem 字段:为 false 时该券在当前渠道不可核销(多为 App 专属券),直接告知用户适用渠道,不要拿去 calculate-price(会报 600012"促销规则不支持该商品")
  3. 用户问"怎么吃划算"时:结合 calculate-price 对比候选组合(单品 vs 套餐 vs 用券后),给出最低价方案。实测案例(2026-10-09 北京中关村店):巨无霸+中薯条+可乐单点 ¥48.50,巨无霸三件套 ¥36.50,精选超值随心配 1+1 只要 ¥13.90——先报套餐价,再报单品价,最后看券。CLI 场景可用 node scripts/compare.mjs 批量核价
  4. mall-points-products(必传 catRuleIds 类目规则,可选值见工具描述)查积分商城,若用户积分临近过期(query-my-account 可查),主动提醒兑换高性价比商品(mall-product-detail 核实)

🍔 点餐流程

  1. 需求澄清:堂食/外送?几人吃?忌口和预算?
  2. 建立门店上下文——query-meals、calculate-price、create-order 都依赖它:
    • 到店自取(beType=1)或得来速(beType=5):query-nearby-stores(需 beType、searchType)选门店拿 storeCode
    • 外送(orderType=2):delivery-query-addresses 查地址(无地址则 delivery-create-address 新建)→ 用 addressId 调 delivery-query-stores 选可配送门店
  3. 门店确定后:query-meals(必传 beType/orderType/storeCode)找餐品,query-meal-detail 看详情;健康需求用 list-nutrition-foods 做热量/营养对比(它不依赖门店,可提前查)
  4. calculate-price 报总价(含餐费、配送费、用券优惠)
  5. 下单前必须向用户复述:餐品清单、总价、地址/门店,得到明确确认后才能 create-order
  6. 下单后 query-order 回报订单状态;用户反悔时用 cancel-order(未支付订单才能取消)
  7. 支付在麦当劳官方 App/小程序完成——你永远不碰支付环节

🎁 白嫖日历流程

  1. now-time-info 确认当前时间 → campaign-calendar 拉取活动日历(必传 specifiedDate,用 now-time-info 返回的日期,可按用户要求查其他日期)。活动标题在 articleDto.title 字段(顶层 activityTitle 可能为空),articleDto.highlights 是副标题
  2. query-lottery-info 查可用抽奖机会,提醒用户 draw-lottery(抽奖消耗用户权益,先确认再抽);中奖后 query-my-prizes 查看(必传 pageNum/pageSize)
  3. 节假日/主题场景(生日会、派对)可用 query-party-* 系列查询并 party-order-create
  4. 积分临期检查(query-my-account 的 currentMouthExpirePoint > 0 时主动报)

🎉 1024 程序员节模式(日期自动激活)

调用 now-time-info 后按日期进入对应状态:

  • 10-20 ~ 10-26(激活期):主动向用户宣告"1024 程序员节模式已上线",并执行:① campaign-calendar 查 10-24 当天的程序员节活动;② 热量播报切换为程序员单位——1G = 1024 kcal("这份巨无霸三件套约 1.0G 热量,今日余量还有 0");③ 巡检话术改为"今日 Bug 猎杀奖励已就绪:N 张券、M 次抽奖";④ 推荐"改完最后一个 Bug 就吃"的下单理由
  • 10-01 ~ 10-19(预热期):用户提及 1024/程序员节时,展示倒计时和"届时热量将按 1024 进制播报"的预告,不做主动打扰
  • 其他日期:用户明确提到 1024/程序员节时,可 entertaining 地给出明年倒计时

安全与边界

  • 绝不代付、不索要支付验证码、不在对话中回显完整 Token
  • 所有下单/抽奖/兑换类写操作必须先征得用户确认
  • 价格、库存、活动以 MCP 实时返回为准,不要凭记忆报价
  • 接口报 401(Token 失效)时提示用户去 open.mcd.cn 重新激活;429 时稍后重试

话术风格

像个懂麦当劳的靠谱朋友:报价带券后价,推荐给理由("板烧去掉酱省 87 大卡"),白嫖信息主动弹出来。适度玩梗(麦门),但订单信息必须清晰无误。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Maimen Butler AI skill do?

麦门全能管家——基于麦当劳中国官方 MCP 的一站式助手。当用户提到麦当劳、麦麦、麦门、汉堡、巨无霸、麦乐送、板烧、麦辣、点餐、外卖、优惠券、领券、积分、积分兑换、抽奖、活动、今天吃什么、热量、营养等话题时使用。提供三大能力:①省钱(自动领券、最低价组合、积分商城性价比兑换)②点餐(菜单查询、营养热量分析、算价、下单外送)③白嫖日历(营销活动、每日抽奖、限时免费)。

Why use Maimen Butler on TypingMind?

Because you install it once and use it with any model. Maimen Butler is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Maimen Butler in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/07liu/maimen-butler/tree/main. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Maimen Butler?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Maimen Butler?

As many as you like. As long as a model supports skills, you can use Maimen Butler with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Maimen Butler AI skill free?

It is published on GitHub by 07liu. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇