今天喝什么茶
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"tea-planner": {
"args": [
"tea-chay-advisor"
],
"command": "uvx",
"env": {}
}
}
}可用工具 （11 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
recommend 4 个参数
推荐今天（或指定日期时间）喝什么茶，输出 400ml 壶泡一泡的完整参数。 参数: datetime_str: 可选，ISO 格式 '2026-02-14T20:30'；缺省用系统当前时间 randomness: 0~1 随机程度。0=非常应季规律，1=非常随机惊喜。默认 0.6 count: 返回几款（主推+备选），默认 1，最多 5 mood: 可选偏好词，如 '想喝香的' / '清淡' / '暖胃' / '提神' / '安神'
该工具无需必填参数，直接调用即可
record 1 个参数 需填 1 项
记录「我刚喝了XX」，用于疲劳降权与库存轮换。茶名可模糊匹配。
必填参数：name
undo_record
撤销最近一条喝茶记录（记错了可悔）。
该工具无需必填参数，直接调用即可
inventory 1 个参数
列出库存茶品及壶泡参数。category 可选：绿茶/调味绿茶/花茶/白茶/黄茶/乌龙茶/红茶/调味红茶/黑茶/代用茶。
该工具无需必填参数，直接调用即可
history 1 个参数
查看最近喝茶记录。
该工具无需必填参数，直接调用即可
add_tea 7 个参数 需填 1 项
「我买了XX」：新茶入库。支持批量：「我买了龙井、铁观音、正山小种」一次入库多款。 与内置茶全名相同的会恢复原参数（搬家清空后可用）；新茶自动按类别套默认壶泡参数。 参数: name: 茶名（必填）。多个茶名可用顿号/逗号/分号/换行分隔 category: 可选类别（可模糊，「普洱」会归到黑茶）；批量导入时用于无法从茶名推断的茶 note: 可选备注，如「明前」「2024年」「朋友送的」 g/temp/minutes/rinse: 可选自定义壶泡参数（400ml一泡）。0 或 -1 表示用类别默认；批量模式不支持显式参数
必填参数：name
remove_tea 1 个参数 需填 1 项
「我喝光了XX」：把茶移出库存。内置茶标记为喝光（可说「我买了XX」恢复）；自购茶直接删除。茶名模糊匹配。
必填参数：name
clear_inventory 1 个参数
「我搬到了外地」：清空全部库存（内置107款全部标记移除、自购茶删除）与喝茶历史、复盘调校。 清空后可用「我买了XX、YY、ZZ」批量导入新茶单；与内置茶全名相同的会自动恢复原参数。 参数: confirm: 必须为 True 才真正执行（防误触）。首次调用返回预览。
该工具无需必填参数，直接调用即可
set_brewer 3 个参数
修改壶具容量：「我的茶壶是500ml」/「冷泡壶换成2L」。投茶量按茶水比自动等比缩放，水温/时间不变。 默认 400ml 茶壶 + 1.6L 冷泡壶；存储的投茶量始终是 400ml/1.6L 基准值，仅显示时折算。 参数: pot_ml: 茶壶容量 ml（100~3000），>=0 才生效 cold_ml: 冷泡壶容量 ml（500~6000），>=0 才生效 reset: True 恢复默认 400ml / 1.6L
该工具无需必填参数，直接调用即可
coldbrew_recommend 3 个参数
「今天冷泡什么」：为 1.6L 冷泡壶推荐冷泡茶（冷藏层约4℃）。 输出投茶量、冷藏时长、预计可饮时间。抹茶/可可/茶膏/药茶丸不适合冷泡壶，自动排除。 参数: datetime_str: 可选，ISO 格式 '2026-08-16T21:30'；缺省用系统当前时间（用于计算"几点能喝"） randomness: 0~1 随机程度，默认 0.6 count: 返回几款（主推+备选），默认 1，最多 5
该工具无需必填参数，直接调用即可
review 11 个参数 需填 1 项
「复盘」：记录喝感评价，并自动微调该款茶的热泡/冷泡参数（持久化到 state.json）。 理论参数只是起点——商家优劣、陈化、储存变质都会让实际口感偏离，复盘让参数贴合你的真实杯子。 参数: name: 茶名（必填，模糊匹配库存） feedback: 喝感反馈词。'太淡'/'不够味'→加量延时加温；'太浓'/'苦'→减量延时降温；'涩'→降温减时； '仓气重'/'仓味'/'堆味'/'霉味'→洗茶档位+1；'洗茶太过'/'香味洗掉'→洗茶档位-1； '闷味'/'闷熟'→改开盖泡；'香气散'/'跑香'→改盖盖泡； '泡酸'/'发酸'→降温（红茶高温出酸）；'香味没了'/'没香气'→降温（高温毁香）； '正好'/'好喝'→记录不调；含'重置'→清除调校。多维可组合（如'仓气重还淡'、'香味没了还淡'）。 mode: hot=热泡壶泡（默认）；cold=冷泡 reset: True 直接清除该茶该场景的调校（等价 feedback 含'重置'） g/temp/minutes: 直接指定热泡目标参数（投茶g/水温℃/浸泡min，>=0 才生效，优先于自动调整） hours: 直接指定冷泡冷藏小时数（>=0 生效） prewash: 直接指定洗茶档位 0~6（0=不洗，2=生普默认，4=熟普/六堡/砖茶默认；>=0 生效） lid: 直接指定盖盖/开盖：1=盖盖（存香保温），0=开盖（散气防闷）；>=0 生效 note: 可选备注，如 '商家这批偏淡' / '放久了仓气重'
必填参数：name
服务介绍
🍵 今天喝什么茶 · tea-planner MCP
无由持一碗，寄与爱茶人。 —— 白居易
休对故人思故国，且将新火试新茶。诗酒趁年华。 —— 苏轼
事情是这样的：家里茶越来越多，多到每次打开柜子要发呆五分钟，最后拿的还是离手最近的那一盒。茶叶受潮怪自己，选择困难也怪自己，不如让程序背锅。
于是有了这个挂在 Cherry Studio 上的 MCP——「今天喝什么」。内置 107 款茶的壶泡参数（绿茶、乌龙、黑茶、红茶、白茶、黄茶、花茶，还有一堆说不清该归哪类的怪东西），每天替你抛一枚有理由的硬币：按季节、时段、最近喝没喝过、库存积灰程度加权抽签。夏天也能抽中熟普，只是概率低；深夜也不会只塞给你代用茶——规则是软的，没有哪款茶被判死刑。
有什么工具（11 个）
| 工具 | 你说的话 |
|---|---|
recommend |
今天喝什么？ |
coldbrew_recommend |
今天冷泡什么？ |
add_tea |
我买了龙井、铁观音、正山小种（支持批量） |
remove_tea |
我喝光了碧螺春 |
clear_inventory |
我搬到了外地（一键清空，别继承作者的茶柜） |
set_brewer |
我的茶壶是 300ml / 冷泡壶换成 2L |
review |
太淡了 / 有点苦 / 仓气重 / 洗茶太过 / 闷味 / 泡酸了 / 香味没了 |
record / undo_record / history |
我喝了XX / 记错了撤回 / 最近喝过啥 |
部署（Cherry Studio，两分钟）
需要 uv（自带 uvx）：
uvx tea-chay-advisor
Cherry Studio → 设置 → MCP 服务器 → 导入这段 JSON：
{
"mcpServers": {
"tea-planner": {
"command": "uvx",
"args": ["tea-chay-advisor"],
"env": {}
}
}
}
打开开关，工具列表出现 11 个工具即成功。uvx 会自动从 PyPI 拉取 tea-chay-advisor，不用再手动装 Python 依赖，也不用改本地路径。
然后在相应位置部署SKILL.md
开箱三步
- 搬家：「我搬到了外地」→ 把作者的 107 款茶清空（确认两次才动手，不误伤）
- 进货：「我买了龙井、大红袍、老白茶」→ 批量入库，参数自动按类别套好
- 开喝：「今天喝什么？」→ 剩下的事程序替你纠结
关于泡法（动手前先看这条）
这不是功夫茶泡法。 没有盖碗、没有快出汤、没有"一泡香二泡水三泡茶"。作者自用的是 400ml 大茶壶 + 1.6L 冷泡壶、TDS20 纯净水，一次注满、泡四五分钟、一次性出汤、茶水分离，路数接近茶叶审评和英式茶壶。所有投茶量、水温、时间都按这个场景校准。
茶具不一样？说一句「我的茶壶是 500ml」，投茶量自动按茶水比缩放，水温时间不动。冷泡同理。
复盘：让茶越喝越对味
理论参数只是起点，商家批次、仓储年份都会让茶偏离说明书。喝得不对味就说：
- 太淡 / 太浓 / 涩 → 自动微调投茶、时间、水温
- 仓气重 / 洗茶太过 → 调洗茶档位（生普默认：快洗1次+慢洗1次+散味2分钟；熟普/六堡/边销砖：快洗2次+慢洗1次+散味2分钟+快洗1次）
- 闷味 / 香气散 → 盖盖还是开盖
- 泡酸了 / 香味没了 → 水温降 3℃
- 调过头了说「重置XX」，一键回到理论值
所有数据都写在脚本旁边的 state.json 里，备份这一个文件，口味就能跟你搬家。
仅供参考。 茶是你的茶，嘴是你的嘴，参数是理论的，好喝才算数。程序不会泡茶，它只会抛一枚比较讲道理的硬币。
