What is this?
A fan-made, unofficial entry for a McDonald's China developer contest that turns your McDonald's order history into a fictional 'martial arts sect' identity, producing an animated annual report, a business card, and a personal avatar image based on McDonald's China MCP data.
A fan-made, unofficial entry for a McDonald's China developer contest that turns your McDonald's order history into a fictional 'martial arts sect' identity, producing an animated annual report, a business card, and a personal avatar image based on McDonald's China MCP data.Is this a web app, or something I run on my own machine?It is a Python command-line tool (also usable as a Claude Agent Skill) that renders fully self-contained HTML and PNG files on your machine; you just double-click the HTML and open it in Chrome, Edge or Safari, with no server or CDN involved.
It is a Python command-line tool (also usable as a Claude Agent Skill) that renders fully self-contained HTML and PNG files on your machine; you just double-click the HTML and open it in Chrome, Edge or Safari, with no server or CDN involved.How do I get it running?Install Python 3.9+ (and Node.js 20+ if you want PNG export), apply for a Token on the McDonald's MCP open platform, then run the CLI, which supports --year, --output and --mock-data flags.
Install Python 3.9+ (and Node.js 20+ if you want PNG export), apply for a Token on the McDonald's MCP open platform, then run the CLI, which supports --year, --output and --mock-data flags.Do I need an MCP Token before anything works?Yes, you must apply for a Token on the official McDonald's MCP open platform, then either paste it into the Agent chat for one-time use or save it to a git-ignored .env file as MCD_MCP_TOKEN.
Yes, you must apply for a Token on the official McDonald's MCP open platform, then either paste it into the Agent chat for one-time use or save it to a git-ignored .env file as MCD_MCP_TOKEN.Does it ever guess or make up missing order data?No. If spending amounts or item details are missing it does not fabricate them, and if the real-data mode fails it will not silently fall back to sample data.
No. If spending amounts or item details are missing it does not fabricate them, and if the real-data mode fails it will not silently fall back to sample data.How is my rank (阅历/境界) actually calculated?Experience score = completed orders x2 + min(months with orders, 12) + min(dish varieties, 12). The top rank '麦门真神' caps at 160 points, and neither gender nor amount spent affects the score.
Experience score = completed orders x2 + min(months with orders, 12) + min(dish varieties, 12). The top rank '麦门真神' caps at 160 points, and neither gender nor amount spent affects the score.How does it decide which sect (门派) I belong to?Your most-ordered dish category maps to one of six sects, like 薯山剑派 for fries or 金堡门 for burgers, and any unrecognized items default to the catch-all 逍遥门 sect.
Your most-ordered dish category maps to one of six sects, like 薯山剑派 for fries or 金堡门 for burgers, and any unrecognized items default to the catch-all 逍遥门 sect.Does it need to call an AI image model every time I run it?No, all 18 level portraits (9 male, 9 female) are pre-generated and shipped with the project, so normal use needs zero live image generation; an optional AI avatar extension is only used if you explicitly ask for it.
No, all 18 level portraits (9 male, 9 female) are pre-generated and shipped with the project, so normal use needs zero live image generation; an optional AI avatar extension is only used if you explicitly ask for it.Is this an official McDonald's product?No, the README explicitly states it is an independent contest entry for a McDonald's China developer creativity competition, not an official McDonald's app.
No, the README explicitly states it is an independent contest entry for a McDonald's China developer creativity competition, not an official McDonald's app.What are similar projects?human-writing, seedance2-skill, china-travel-kit, im-not-ai, simplified-technical-english, live-panel-skill, skills, mcd-saver-strategist
human-writing, seedance2-skill, china-travel-kit, im-not-ai, simplified-technical-english, live-panel-skill, skills, mcd-saver-strategistWhich topics is it in?meme, generative-art, claude-skill, chinese-language, model-context-protocol, json, skill, offline, china, html, agent-skills, command-line-tool
meme, generative-art, claude-skill, chinese-language, model-context-protocol, json, skill, offline, china, html, agent-skills, command-line-tool