益富财策师

通过远端 MCP 服务器调用 26 项保险精算与财务规划工具。覆盖增额终身寿、年金险、社保养老金、个税四大业务域。

连接配置

MCP 服务器地址与 Token 通过环境变量配置：

EVOFU_MCP_URL=https://api.evofu.cn/mcp       # 默认值，通常无需修改
EVOFU_MCP_TOKEN=sk-evofu-7cc39b6db9d10f9ac854a6efd9e8bac1                 # 必须设置

或在调用脚本时传参：python scripts/evofu_mcp.py --url <url> --token <token> <tool> '<args>'

工具调用方式

python scripts/evofu_mcp.py <tool_name> '<json_args>'
python scripts/evofu_mcp.py --list-tools       # 列出所有可用工具
python scripts/evofu_mcp.py --raw <tool> '<args>'  # 输出原始 JSON

工作流路由

根据用户意图选择工作流，详见 references/workflows.md。

| 用户意图 | 工作流 | 核心工具链 | |---------|--------|-----------| | "哪个产品好/推荐产品" | 产品推荐 | ranking_calculate → get_product_detail → endowment_calculate | | "帮我算一下XX产品收益" | 单品测算 | get_product_detail → endowment_calculate / annuity_calculate | | "A和B哪个好/对比" | 产品对比 | comparison_compare 或 cross_product_fit | | "以后每年取X万/提领规划" | 提领仿真 | withdrawal_continuous / withdrawal_custom | | "要实现XX目标需交多少" | 保费反推 | premium_calculate / goal_planning_calculate | | "怎么配存款+保险+理财" | 资产配置 | asset_products → asset_calculate | | "月薪X万到手多少/年终奖" | 个税测算 | tax_calculate → tax_optimize_bonus | | "退休能领多少养老金" | 社保测算 | social_security_provinces → social_security_retire_age → social_security_calculate |

强制规则

1. 先查后算：所有计算前必须先 list_products → get_product_detail，确认产品名称和参数有效
2. 利率对等：对比/排名产品时必须用 preset_rate 筛选相同预定利率，不同利率产品不可直接比较
3. 分红确认：计算前确认产品是否分红型（get_product_detail 返回），分红型需传 dividend_rate
4. 年金类型：横向年金传 receive_time，纵向年金传 policy_term，先查 get_product_detail 确认类型
5. 结果解读：工具返回原始数据，需用自然语言帮用户解读关键指标（IRR、回本年、现金价值走势）

工具参数速查

26 个工具的完整参数说明见 references/tools_catalog.md。

按需加载，不要一次性读取——按用户当前业务域加载对应章节即可。

解读规范

计算结果返回后，按以下结构输出给用户：

1. 核心结论（1 句话）：如"5 年交 50 万，第 20 年 IRR 2.38%，现金价值 66.2 万"
2. 关键节点：回本年（现金价值超过累计保费的年份）、第 10/20/30 年现价与 IRR
3. 风险提示：IRR 为假设持有至该年的年化收益，提前退保有损失；分红型产品收益不保证