让你的 AI 帮你盯快递:加单、自动巡查、状态变化主动告知。MCP 服务 + 可嵌入的 FastAPI 路由。
Server has 6 tools with complete input schemas and descriptions. Tool names use verb_noun pattern (express_add, express_list, express_track, express_pause, express_remove, express_settings). Descriptions are present but vary in quality, some are concise (express_list: 16 chars), others verbose with Chinese-language implementation details. All parameters have type definitions and descriptions. However, descriptions lack actionable guidance for LLM selection (when to use express_track vs express_add?), error recovery paths are minimal, and output schemas are not formally documented. Tool annotations are present (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), which is excellent. Parameter defaults are reasonable (note='', mobile_last4='', company_code=''). No enum constraints on company_code despite it accepting 'ZTO', '中通', etc. Error messages in code are generic ('没登记上', '查不到'). Composition is sound, each tool has one responsibility. Chinese-language descriptions may reduce LLM clarity in English-first agents.
登记一个包裹并立刻查一次。number=快递单号;note=这是什么(如'植物灯');mobile_last4=收件手机后四位(顺丰/中通必填);company_code=快递公司(一般别填,自动识别;要填写中文名或代码如 中通/ZTO)。
列出在途的包裹(include_archived=True 连已签收的一起列)。
暂停(paused=True)或恢复(False)某一单的自动巡查。用户说'这个先别盯了'就暂停,'继续盯'就恢复。
不盯了/删掉一单。key=单号或备注关键词。
看/改巡查设置与额度。不传参数=只看:用量(今天/本月/总计/配额)和巡查间隔。续费后:quota=新额度, reset_usage=True 重新计数;poll_minutes 调巡查间隔(5~720)。
现在就查一单的最新轨迹。key=单号或备注关键词;没登记过的单号也能直接查(不入库)。company_code 一般别填。
Descriptions are Chinese-language and lack English clarity. express_list description is only 16 characters ('列出在途的包裹...'), below the 34-char p10 baseline. LLMs trained primarily on English may misinterpret intent.
No enum constraint on company_code parameter despite accepting specific values ('ZTO', '中通', 'SF', etc.). LLMs may hallucinate invalid codes. Should declare enum or provide validation with actionable error.
Output schemas are not formally documented. Code returns formatted strings (_fmt, _trace_lines) rather than structured JSON. LLMs cannot reliably extract fields for downstream tool calls (e.g., package number from express_list result).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
Error messages are generic Chinese strings ('没登记上', '查不到', '没改成') with no recovery guidance. LLMs cannot determine if error is retryable, user-fixable, or fatal.
Tool descriptions do not explain when to use one tool vs another. express_track and express_add both query packages; unclear when LLM should choose each. Adds reasoning overhead.