香港保险数据 MCP 服务器 - 提供香港保险产品数据查询、对比、计算等功能。包含产品列表、详情、对比、搜索、保司列表、分红实现率、退休计算器、保额计算器、减保提取模拟器等工具。
Server has 9 tools with complete input schemas and descriptions visible in source. However, descriptions are domain-specific (Chinese insurance terminology) and lack LLM-optimized guidance on WHEN to use each tool or HOW they differ. Parameter descriptions are present but minimal (avg ~40 chars). No output schemas documented, responses are JSON but structure is inferred from code. Error handling is basic (try/except with generic _err wrapper). Tools follow verb_noun naming (list_, get_, search_, compare_) but lack actionable error recovery guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are READ_ONLY per metadata, but this is not declared in tool definitions themselves.
多产品并排对比(2-4个): 对比20/30年IRR(保证+预期)、回本年、保证占比、回报倍数、评级、卖点。ids=产品id数组。
保额计算器:基于年收入计算推荐保额。支持三种模式:基础(年收入×7)、标准(年收入×10+教育费)、充裕(年收入×15)。
分红实现率明细:查询分红实现率数据,支持全局、按保司、按产品维度。含官方来源。
单产品完整详情:卖点文案(tagline/目标客户/卖点)、IRR20/30(保证+预期)、回本年、保证占比、回报倍数、保障年期、缴费方式、缴费期、评级、建议书演示(含逐年现金流)、分红实现率、材料文件。
保司列表:返回所有保险公司及其产品数量。
香港保险产品列表:按险种过滤。type可选: savings储蓄/life寿险/medical医疗/critical危疾/annuity年金/ilas投资相连/term-life定期寿/accident意外/iul指数型万用/universal-life万用寿险。不传type返回全部。按20年预期IRR排序。
退休计算器:基于年化IRR积累计算月领金额,返回逐年现金流。输入年化IRR、缴费年限、月缴费、领取年限,计算退休后月领金额及现金流。
No output schemas documented. Responses are JSON but structure is inferred from code only. LLMs cannot plan downstream tool calls without knowing what fields to expect.
Tool annotations missing. All tools are READ_ONLY per metadata, but readOnlyHint is not declared in tool definitions. Agents cannot distinguish safe vs destructive operations.
Error handling is generic. _err() returns only {ok: false, error: str(e)}. No recovery guidance, error classification, or actionable next steps for LLMs.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
关键词搜索产品:按产品名、保司名、卖点关键词搜索。返回匹配的产品列表。
减保提取模拟器:模拟减保提取对IRR的影响。使用对数内插和二分法计算IRR。输入产品ID、缴费方案、提取金额和时间,返回提取后的IRR。
Descriptions lack LLM-optimized guidance. Descriptions state WHAT (e.g. '按险种过滤') but not WHEN to use or HOW this tool differs from similar ones (e.g. list_products vs search_products).
Parameter descriptions are minimal. 'type' param in list_products has 40-char description; no guidance on when to omit it or what happens if invalid type is passed.