aigroup-econ-mcp 0.7.0__py3-none-any.whl → 0.8.0__py3-none-any.whl

aigroup_econ_mcp/tools/tool_descriptions.py

@@ -570,33 +570,133 @@ VARIANCE_DECOMPOSITION_ANALYSIS = ToolDescription(
 
 RANDOM_FOREST_REGRESSION_ANALYSIS = ToolDescription(
     name="random_forest_regression_analysis",
-    description="随机森林回归 - 支持文件输入",
+    description="""随机森林回归分析
+
+📊 功能说明：
+随机森林通过构建多个决策树并集成结果，能够处理复杂的非线性关系和特征交互。
+
+📈 算法特点：
+- 集成学习：多个决策树投票或平均结果
+- 稳健性：对异常值和噪声数据稳健
+- 特征重要性：自动计算特征重要性分数
+- 袋外评估：使用袋外样本进行模型评估
+- 并行训练：支持并行化训练加速
+
+💡 适用场景：
+- 复杂非线性关系建模
+- 特征交互分析
+- 稳健预测需求
+- 特征重要性评估
+- 大数据集处理
+
+⚠️ 注意事项：
+- 黑盒模型，可解释性较差
+- 内存消耗较大（树的数量多时）
+- 训练时间随树数量增加
+- 可能过度拟合噪声数据
+
+🔧 参数建议：
+- n_estimators: 树的数量，默认100
+  - 小数据集: 50-100
+  - 大数据集: 100-500
+- max_depth: 最大深度，默认None（无限制）
+  - 控制过拟合: 5-15
+  - 复杂关系: None（无限制）
+
+📋 数据要求：
+- 至少10个样本
+- 数值型和类别型数据
+- 支持缺失值处理""",
     field_descriptions={
-        "file_path": "文件路径",
-        "file_content": "文件内容",
-        "file_format": "文件格式",
-        "y_data": "因变量数据",
-        "x_data": "自变量数据",
-        "feature_names": "特征名称",
-        "n_estimators": "树的数量",
-        "max_depth": "最大深度"
-    }
+        "file_path": "CSV/JSON文件路径。CSV格式: 最后一列为因变量，其余列为自变量",
+        "file_content": "文件内容字符串。JSON格式: {'y': [因变量], 'x1': [自变量1], ...}",
+        "file_format": "文件格式: csv/json/auto",
+        "y_data": "因变量数据列表，数值格式，如 [1.2, 3.4, 5.6, ...]",
+        "x_data": "自变量数据矩阵，二维列表格式，如 [[1, 2], [3, 4], [5, 6], ...]",
+        "feature_names": "自变量名称列表，如 ['GDP', 'Population', 'Investment']",
+        "n_estimators": "决策树数量，控制模型复杂度和稳定性，默认100",
+        "max_depth": "决策树最大深度，控制过拟合，默认None（无限制）"
+    },
+    examples=[
+        "预测房价与房屋特征的非线性关系",
+        "分析消费者行为与营销变量的复杂交互",
+        "评估经济指标对股票收益的影响"
+    ],
+    use_cases=[
+        "复杂非线性关系建模",
+        "特征重要性分析",
+        "稳健预测建模",
+        "大数据集处理",
+        "集成学习应用"
+    ]
 )
 
 GRADIENT_BOOSTING_REGRESSION_ANALYSIS = ToolDescription(
     name="gradient_boosting_regression_analysis",
-    description="梯度提升树回归 - 支持文件输入",
+    description="""梯度提升树回归分析
+
+📊 功能说明：
+梯度提升树通过顺序构建决策树，每棵树修正前一棵树的错误，能够处理复杂的非线性关系。
+
+📈 算法特点：
+- 顺序学习：每棵树学习前一棵树的残差
+- 高精度：通常具有很高的预测精度
+- 特征重要性：自动计算特征重要性
+- 灵活性强：可处理各种类型的数据
+- 正则化：内置正则化防止过拟合
+
+💡 适用场景：
+- 高精度预测需求
+- 复杂非线性关系
+- 小样本高维数据
+- 竞赛和性能要求高的场景
+- 特征重要性分析
+
+⚠️ 注意事项：
+- 对参数敏感，需要仔细调优
+- 训练时间较长
+- 可能过度拟合噪声数据
+- 内存消耗较大
+
+🔧 参数建议：
+- n_estimators: 树的数量，默认100
+  - 小数据集: 50-200
+  - 大数据集: 200-1000
+- learning_rate: 学习率，默认0.1
+  - 保守学习: 0.01-0.1
+  - 快速收敛: 0.1-0.3
+- max_depth: 最大深度，默认3
+  - 简单关系: 2-4
+  - 复杂关系: 5-8
+
+📋 数据要求：
+- 至少10个样本
+- 数值型和类别型数据
+- 建议进行数据标准化""",
     field_descriptions={
-        "file_path": "文件路径",
-        "file_content": "文件内容",
-        "file_format": "文件格式",
-        "y_data": "因变量数据",
-        "x_data": "自变量数据",
-        "feature_names": "特征名称",
-        "n_estimators": "树的数量",
-        "learning_rate": "学习率",
-        "max_depth": "最大深度"
-    }
+        "file_path": "CSV/JSON文件路径。CSV格式: 最后一列为因变量，其余列为自变量",
+        "file_content": "文件内容字符串。JSON格式: {'y': [因变量], 'x1': [自变量1], ...}",
+        "file_format": "文件格式: csv/json/auto",
+        "y_data": "因变量数据列表，数值格式，如 [1.2, 3.4, 5.6, ...]",
+        "x_data": "自变量数据矩阵，二维列表格式，如 [[1, 2], [3, 4], [5, 6], ...]",
+        "feature_names": "自变量名称列表，如 ['GDP', 'Population', 'Investment']",
+        "n_estimators": "提升阶段执行的树数量，控制模型复杂度，默认100",
+        "learning_rate": "学习率，控制每棵树的贡献程度，默认0.1",
+        "max_depth": "单个回归估计器的最大深度，控制过拟合，默认3"
+    },
+    examples=[
+        "高精度预测股票价格走势",
+        "分析复杂的经济指标关系",
+        "预测消费者购买行为的精确概率",
+        "竞赛级别的预测建模"
+    ],
+    use_cases=[
+        "高精度预测建模",
+        "复杂非线性关系分析",
+        "特征重要性评估",
+        "小样本高维数据处理",
+        "竞赛级别模型构建"
+    ]
 )
 
 LASSO_REGRESSION_ANALYSIS = ToolDescription(

aigroup_econ_mcp/tools/tool_handlers.py

@@ -320,7 +320,7 @@ async def handle_panel_hausman_test(ctx, y_data, x_data, entity_ids, time_period
 
 async def handle_panel_unit_root_test(ctx, **kwargs):
     """
-    处理面板单位根检验
+    处理面板单位根检验 - 统一输出格式
     
     panel_unit_root_test函数期望：data, entity_ids, time_periods
     但panel装饰器会传入：y_data, x_data, entity_ids, time_periods
@@ -344,68 +344,310 @@ async def handle_panel_unit_root_test(ctx, **kwargs):
     
     # 只传递panel_unit_root_test需要的参数
     result = panel_unit_root_test(data, entity_ids, time_periods, test_type)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 面板单位根检验结果
+
+🔍 检验信息：
+- 检验方法 = {test_type.upper()}
+- 个体数量 = {len(set(entity_ids))}
+- 时间期数 = {len(set(time_periods))}
+- 检验统计量 = {result.statistic:.4f}
+- p值 = {result.p_value:.4f}
+- 平稳性 = {'平稳' if result.stationary else '非平稳'} (5%水平)
+
+📈 检验详情："""
+    
+    # 添加检验详情信息
+    if hasattr(result, 'critical_values'):
+        result_text += f"\n- 临界值: {result.critical_values}"
+    if hasattr(result, 'lags_used'):
+        result_text += f"\n- 使用滞后阶数: {result.lags_used}"
+    if hasattr(result, 'test_statistic'):
+        result_text += f"\n- 检验统计量: {result.test_statistic:.4f}"
+    
+    result_text += f"\n\n💡 检验说明：面板单位根检验用于判断面板数据是否平稳，是面板数据分析的重要前提检验。"
+    result_text += f"\n\n⚠️ 注意事项：如果数据非平稳，需要进行差分处理或使用面板协整检验。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"面板单位根检验: {'平稳' if result.stationary else '非平稳'}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
 
 # 时间序列处理器
 async def handle_var_model(ctx, data, max_lags=5, ic="aic", **kwargs):
+    """处理VAR模型分析 - 统一输出格式"""
     result = var_model(data, max_lags=max_lags, ic=ic)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 VAR模型分析结果
+
+🔍 模型基本信息：
+- 最优滞后阶数 = {result.order}
+- 变量数量 = {len(result.variables) if hasattr(result, 'variables') else '未知'}
+- 信息准则 = {ic.upper()}
+- AIC = {result.aic:.2f}
+- BIC = {getattr(result, 'bic', 'N/A')}
+- HQIC = {getattr(result, 'hqic', 'N/A')}
+
+📈 模型诊断信息："""
+    
+    # 添加模型诊断信息
+    if hasattr(result, 'residuals_normality'):
+        result_text += f"\n- 残差正态性检验: {result.residuals_normality}"
+    if hasattr(result, 'serial_correlation'):
+        result_text += f"\n- 序列相关性检验: {result.serial_correlation}"
+    if hasattr(result, 'stability'):
+        result_text += f"\n- 模型稳定性: {result.stability}"
+    
+    # 添加变量信息
+    if hasattr(result, 'variables'):
+        result_text += f"\n\n🔬 分析变量："
+        for var in result.variables:
+            result_text += f"\n- {var}"
+    
+    result_text += f"\n\n💡 模型说明：VAR模型用于分析多个时间序列变量间的动态关系，能够捕捉变量间的相互影响和滞后效应。"
+    result_text += f"\n\n⚠️ 注意事项：VAR模型假设所有变量都是内生的，适用于分析变量间的动态交互关系。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"VAR模型: 滞后阶数={result.order}, AIC={result.aic:.2f}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
 
 async def handle_vecm_model(ctx, data, coint_rank=1, deterministic="co", max_lags=5, **kwargs):
+    """处理VECM模型分析 - 统一输出格式"""
     result = vecm_model(data, coint_rank=coint_rank, deterministic=deterministic, max_lags=max_lags)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 VECM模型分析结果
+
+🔍 模型基本信息：
+- 协整秩 = {result.coint_rank}
+- 确定性项类型 = {deterministic}
+- 最大滞后阶数 = {max_lags}
+- AIC = {result.aic:.2f}
+- BIC = {getattr(result, 'bic', 'N/A')}
+- HQIC = {getattr(result, 'hqic', 'N/A')}
+
+📈 协整关系分析："""
+    
+    # 添加协整关系信息
+    if hasattr(result, 'coint_relations'):
+        result_text += f"\n- 协整关系数量: {len(result.coint_relations)}"
+        for i, relation in enumerate(result.coint_relations[:3], 1):  # 显示前3个关系
+            result_text += f"\n- 关系{i}: {relation}"
+        if len(result.coint_relations) > 3:
+            result_text += f"\n- ... 还有{len(result.coint_relations) - 3}个协整关系"
+    
+    # 添加误差修正项信息
+    if hasattr(result, 'error_correction'):
+        result_text += f"\n\n🔧 误差修正机制："
+        result_text += f"\n- 误差修正项显著性: {result.error_correction}"
+    
+    result_text += f"\n\n💡 模型说明：VECM模型用于分析非平稳时间序列的长期均衡关系，包含误差修正机制来反映短期调整过程。"
+    result_text += f"\n\n⚠️ 注意事项：VECM模型要求变量间存在协整关系，适用于分析经济变量的长期均衡和短期动态调整。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"VECM模型: 协整秩={result.coint_rank}, AIC={result.aic:.2f}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
 
 async def handle_garch_model(ctx, data, order=(1, 1), dist="normal", **kwargs):
+    """处理GARCH模型分析 - 统一输出格式"""
     result = garch_model(data, order=order, dist=dist)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 GARCH模型分析结果
+
+🔍 模型基本信息：
+- GARCH阶数 = ({order[0]}, {order[1]})
+- 误差分布 = {dist}
+- 持久性 = {result.persistence:.4f}
+- AIC = {result.aic:.2f}
+- BIC = {getattr(result, 'bic', 'N/A')}
+
+📈 波动率特征："""
+    
+    # 添加波动率特征信息
+    if hasattr(result, 'volatility_persistence'):
+        result_text += f"\n- 波动率持续性: {result.volatility_persistence:.4f}"
+    if hasattr(result, 'unconditional_variance'):
+        result_text += f"\n- 无条件方差: {result.unconditional_variance:.4f}"
+    if hasattr(result, 'leverage_effect'):
+        result_text += f"\n- 杠杆效应: {result.leverage_effect}"
+    
+    # 添加模型诊断信息
+    if hasattr(result, 'residuals_test'):
+        result_text += f"\n\n🔧 模型诊断："
+        result_text += f"\n- 残差检验: {result.residuals_test}"
+    
+    result_text += f"\n\n💡 模型说明：GARCH模型用于分析金融时间序列的波动率聚类现象，能够捕捉条件异方差性。"
+    result_text += f"\n\n⚠️ 注意事项：GARCH模型适用于金融数据波动率建模，阶数选择影响模型对波动率持续性的捕捉能力。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"GARCH模型: 持久性={result.persistence:.4f}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
 
-async def handle_state_space_model(ctx, data, state_dim=1, observation_dim=1, 
+async def handle_state_space_model(ctx, data, state_dim=1, observation_dim=1,
                                   trend=True, seasonal=False, period=12, **kwargs):
+    """处理状态空间模型分析 - 统一输出格式"""
     result = state_space_model(data, state_dim, observation_dim, trend, seasonal, period)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 状态空间模型分析结果
+
+🔍 模型结构信息：
+- 状态维度 = {result.state_dim}
+- 观测维度 = {result.observation_dim}
+- 趋势项 = {'包含' if result.trend else '不包含'}
+- 季节项 = {'包含' if result.seasonal else '不包含'}
+- 季节周期 = {result.period if result.seasonal else 'N/A'}
+- AIC = {result.aic:.2f}
+- BIC = {getattr(result, 'bic', 'N/A')}
+
+📈 模型拟合信息："""
+    
+    # 添加模型拟合信息
+    if hasattr(result, 'log_likelihood'):
+        result_text += f"\n- 对数似然值: {result.log_likelihood:.2f}"
+    if hasattr(result, 'converged'):
+        result_text += f"\n- 收敛状态: {'已收敛' if result.converged else '未收敛'}"
+    if hasattr(result, 'smoothing_error'):
+        result_text += f"\n- 平滑误差: {result.smoothing_error:.4f}"
+    
+    result_text += f"\n\n💡 模型说明：状态空间模型用于分析时间序列的潜在状态和观测关系，能够处理复杂的动态系统。"
+    result_text += f"\n\n⚠️ 注意事项：状态空间模型适用于分析具有潜在状态的时间序列，参数估计可能对初始值敏感。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"状态空间模型: AIC={result.aic:.2f}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
 
 async def handle_variance_decomposition(ctx, data, periods=10, max_lags=5, **kwargs):
+    """处理方差分解分析 - 统一输出格式"""
     result = variance_decomposition(data, periods=periods, max_lags=max_lags)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 方差分解分析结果
+
+🔍 分析设置：
+- 分解期数 = {periods}
+- 最大滞后阶数 = {max_lags}
+- 变量数量 = {len(result) if isinstance(result, dict) else '未知'}
+
+📈 方差分解结果："""
+    
+    # 添加方差分解结果
+    if isinstance(result, dict):
+        for var_name, decomposition in result.items():
+            if isinstance(decomposition, dict):
+                result_text += f"\n\n🔬 变量 '{var_name}' 的方差来源："
+                for source, percentage in decomposition.items():
+                    result_text += f"\n- {source}: {percentage:.1f}%"
+            else:
+                result_text += f"\n- {var_name}: {decomposition}"
+    else:
+        result_text += f"\n- 结果: {result}"
+    
+    result_text += f"\n\n💡 分析说明：方差分解用于分析多变量系统中各变量对预测误差方差的贡献程度。"
+    result_text += f"\n\n⚠️ 注意事项：方差分解结果依赖于模型的滞后阶数选择，不同期数的分解结果可能不同。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"方差分解: {periods}期")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result
     )
 
 
 # 机器学习处理器
 async def handle_random_forest(ctx, y_data, x_data, feature_names=None, n_estimators=100, max_depth=None, **kwargs):
+    """处理随机森林回归 - 统一输出格式"""
     result = random_forest_regression(y_data, x_data, feature_names, n_estimators, max_depth)
+    
+    # 检查R²是否为负值
+    r2_warning = ""
+    if result.r2_score < 0:
+        r2_warning = f"\n⚠️ 警告：R²为负值({result.r2_score:.4f})，表明模型性能比简单均值预测更差。建议：1) 检查数据质量 2) 增加样本数量 3) 调整模型参数"
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 随机森林回归分析结果
+
+🔍 模型拟合信息：
+- R² = {result.r2_score:.4f}
+- 均方误差(MSE) = {result.mse:.4f}
+- 平均绝对误差(MAE) = {result.mae:.4f}
+- 样本数量 = {result.n_obs}
+- 树的数量 = {result.n_estimators}
+- 最大深度 = {result.max_depth if result.max_depth else '无限制'}
+- 袋外得分 = {f"{result.oob_score:.4f}" if result.oob_score else '未计算'}
+{r2_warning}
+
+📈 特征重要性（前10个）："""
+    
+    # 添加特征重要性信息，按重要性排序
+    if result.feature_importance:
+        sorted_features = sorted(result.feature_importance.items(), key=lambda x: x[1], reverse=True)
+        for i, (feature, importance) in enumerate(sorted_features[:10]):
+            result_text += f"\n- {feature}: {importance:.4f}"
+        if len(sorted_features) > 10:
+            result_text += f"\n- ... 还有{len(sorted_features) - 10}个特征"
+    else:
+        result_text += "\n- 特征重要性未计算"
+    
+    result_text += f"\n\n💡 模型说明：随机森林通过构建多个决策树并集成结果，能够处理非线性关系和特征交互，对异常值稳健且不易过拟合。"
+    result_text += f"\n\n⚠️ 注意事项：随机森林是黑盒模型，可解释性较差，但预测性能通常较好。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"随机森林: R²={result.r2_score:.4f}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
 
-async def handle_gradient_boosting(ctx, y_data, x_data, feature_names=None, 
+async def handle_gradient_boosting(ctx, y_data, x_data, feature_names=None,
                                   n_estimators=100, learning_rate=0.1, max_depth=3, **kwargs):
+    """处理梯度提升树回归 - 统一输出格式"""
     result = gradient_boosting_regression(y_data, x_data, feature_names, n_estimators, learning_rate, max_depth)
+    
+    # 检查R²是否为负值
+    r2_warning = ""
+    if result.r2_score < 0:
+        r2_warning = f"\n⚠️ 警告：R²为负值({result.r2_score:.4f})，表明模型性能比简单均值预测更差。建议：1) 检查数据质量 2) 增加样本数量 3) 调整模型参数"
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 梯度提升树回归分析结果
+
+🔍 模型拟合信息：
+- R² = {result.r2_score:.4f}
+- 均方误差(MSE) = {result.mse:.4f}
+- 平均绝对误差(MAE) = {result.mae:.4f}
+- 样本数量 = {result.n_obs}
+- 树的数量 = {result.n_estimators}
+- 学习率 = {result.learning_rate}
+- 最大深度 = {result.max_depth}
+{r2_warning}
+
+📈 特征重要性（前10个）："""
+    
+    # 添加特征重要性信息，按重要性排序
+    if result.feature_importance:
+        sorted_features = sorted(result.feature_importance.items(), key=lambda x: x[1], reverse=True)
+        for i, (feature, importance) in enumerate(sorted_features[:10]):
+            result_text += f"\n- {feature}: {importance:.4f}"
+        if len(sorted_features) > 10:
+            result_text += f"\n- ... 还有{len(sorted_features) - 10}个特征"
+    else:
+        result_text += "\n- 特征重要性未计算"
+    
+    result_text += f"\n\n💡 模型说明：梯度提升树通过顺序构建决策树，每棵树修正前一棵树的错误，能够处理复杂的非线性关系，通常具有很高的预测精度。"
+    result_text += f"\n\n⚠️ 注意事项：梯度提升树对参数敏感，需要仔细调优，训练时间较长但预测性能优秀。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"梯度提升树: R²={result.r2_score:.4f}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
@@ -491,16 +733,81 @@ async def handle_ridge_regression(ctx, y_data, x_data, feature_names=None, alpha
 
 
 async def handle_cross_validation(ctx, y_data, x_data, model_type="random_forest", cv_folds=5, scoring="r2", **kwargs):
+    """处理交叉验证 - 统一输出格式"""
     result = cross_validation(y_data, x_data, model_type, cv_folds, scoring)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 交叉验证分析结果
+
+🔍 验证信息：
+- 模型类型 = {result.model_type}
+- 交叉验证折数 = {result.n_splits}
+- 评分指标 = {scoring}
+- 平均得分 = {result.mean_score:.4f}
+- 得分标准差 = {result.std_score:.4f}
+- 变异系数 = {(result.std_score / abs(result.mean_score)) * 100 if result.mean_score != 0 else 0:.2f}%
+
+📈 各折得分详情："""
+    
+    # 添加各折得分
+    for i, score in enumerate(result.cv_scores, 1):
+        result_text += f"\n- 第{i}折: {score:.4f}"
+    
+    # 评估模型稳定性
+    stability_assessment = ""
+    cv_threshold = 0.1  # 10%的变异系数阈值
+    cv_value = (result.std_score / abs(result.mean_score)) if result.mean_score != 0 else 0
+    
+    if cv_value < cv_threshold:
+        stability_assessment = f"\n\n✅ 模型稳定性：优秀（变异系数{cv_value*100:.2f}% < {cv_threshold*100:.0f}%）"
+    elif cv_value < cv_threshold * 2:
+        stability_assessment = f"\n\n⚠️ 模型稳定性：一般（变异系数{cv_value*100:.2f}% 在{cv_threshold*100:.0f}%-{cv_threshold*2*100:.0f}%之间）"
+    else:
+        stability_assessment = f"\n\n❌ 模型稳定性：较差（变异系数{cv_value*100:.2f}% > {cv_threshold*2*100:.0f}%）"
+    
+    result_text += stability_assessment
+    result_text += f"\n\n💡 模型说明：交叉验证通过将数据分成多个子集进行训练和测试，评估模型的泛化能力和稳定性。"
+    result_text += f"\n\n⚠️ 注意事项：变异系数越小表明模型越稳定，建议选择变异系数小于10%的模型。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"交叉验证: 平均得分={result.mean_score:.4f}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )
 
 
 async def handle_feature_importance(ctx, y_data, x_data, feature_names=None, method="random_forest", top_k=5, **kwargs):
+    """处理特征重要性分析 - 统一输出格式"""
     result = feature_importance_analysis(y_data, x_data, feature_names, method, top_k)
+    
+    # 构建详细的结果文本
+    result_text = f"""📊 特征重要性分析结果
+
+🔍 分析信息：
+- 分析方法 = {method}
+- 显示Top特征数量 = {top_k}
+- 总特征数量 = {len(result.feature_importance)}
+
+📈 特征重要性排名："""
+    
+    # 添加特征重要性信息
+    for i, (feature, importance) in enumerate(result.sorted_features[:top_k], 1):
+        percentage = (importance / sum(result.feature_importance.values())) * 100 if sum(result.feature_importance.values()) > 0 else 0
+        result_text += f"\n{i}. {feature}: {importance:.4f} ({percentage:.1f}%)"
+    
+    # 添加重要性分布信息
+    if len(result.sorted_features) > 0:
+        top_k_importance = sum(imp for _, imp in result.sorted_features[:top_k])
+        total_importance = sum(result.feature_importance.values())
+        top_k_percentage = (top_k_importance / total_importance) * 100 if total_importance > 0 else 0
+        
+        result_text += f"\n\n📊 重要性分布："
+        result_text += f"\n- Top {top_k}特征累计重要性: {top_k_percentage:.1f}%"
+        result_text += f"\n- 剩余特征重要性: {100 - top_k_percentage:.1f}%"
+    
+    result_text += f"\n\n💡 分析说明：特征重要性分析帮助识别对预测目标最重要的变量，可用于特征选择和模型解释。"
+    result_text += f"\n\n⚠️ 注意事项：不同方法计算的特征重要性可能不同，建议结合业务知识进行解释。"
+    
     return CallToolResult(
-        content=[TextContent(type="text", text=f"特征重要性: Top特征={result.top_features}")],
+        content=[TextContent(type="text", text=result_text)],
         structuredContent=result.model_dump()
     )

{aigroup_econ_mcp-0.7.0.dist-info → aigroup_econ_mcp-0.8.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: aigroup-econ-mcp
-Version: 0.7.0
-Summary: 专业计量经济学MCP工具 - 让大模型直接进行数据分析（优化版：增强工具描述，提升大模型调用体验）
+Version: 0.8.0
+Summary: 专业计量经济学MCP工具 - 让大模型直接进行数据分析（优化版：统一输出格式，增强模型说明）
 Project-URL: Homepage, https://github.com/aigroup/aigroup-econ-mcp
 Project-URL: Repository, https://github.com/aigroup/aigroup-econ-mcp.git
 Project-URL: Issues, https://github.com/aigroup/aigroup-econ-mcp/issues

{aigroup_econ_mcp-0.7.0.dist-info → aigroup_econ_mcp-0.8.0.dist-info}/RECORD

@@ -19,12 +19,12 @@ aigroup_econ_mcp/tools/regression.py,sha256=uMGRGUQo4mU1sb8fwpP2FpkCqt_e9AtqEtUp
 aigroup_econ_mcp/tools/statistics.py,sha256=2cHgNSUXwPYPLxntVOEOL8yF-x92mrgjK-R8kkxDihg,4239
 aigroup_econ_mcp/tools/time_series.py,sha256=LNCO0bYXLPilQ2kSVXA3woNp8ERVq7n3jaoQhWgTCJQ,21763
 aigroup_econ_mcp/tools/timeout.py,sha256=vNnGsR0sXW1xvIbKCF-qPUU3QNDAn_MaQgSxbGxkfW4,8404
-aigroup_econ_mcp/tools/tool_descriptions.py,sha256=yJ6c9Ue3r9HAh3o2t2aGQUu6xfZwJE8B6wC6cqDypDI,28717
-aigroup_econ_mcp/tools/tool_handlers.py,sha256=HZz_AvDtoMzqRmpu6ibZaEUEVUlqsLNifTdlVHEtInk,20613
+aigroup_econ_mcp/tools/tool_descriptions.py,sha256=Oj_14_79AB8Ku64mV0cdoV5f2-UFx-0NY3Xxjj6L-1A,32506
+aigroup_econ_mcp/tools/tool_handlers.py,sha256=RUXCB8dYkS2sbn7pKl3WPI70HQHwCDoy0hEmQMJ8rbs,34399
 aigroup_econ_mcp/tools/tool_registry.py,sha256=4SFpMnReZyGfEHCCDnojwHIUEpuQICS9M2u_9xuoUck,4413
 aigroup_econ_mcp/tools/validation.py,sha256=F7LHwog5xtFIMjD9D48kd8jAF5MsZb7wjdrgaOg8EKo,16657
-aigroup_econ_mcp-0.7.0.dist-info/METADATA,sha256=_GY3y5qGca64s-WWHsdw59nT7aG0wUEZgpLdrnFKvzo,10866
-aigroup_econ_mcp-0.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-aigroup_econ_mcp-0.7.0.dist-info/entry_points.txt,sha256=j5ZJYOc4lAZV-X3XkAuGhzHtIRcJtZ6Gz8ZKPY_QTrM,62
-aigroup_econ_mcp-0.7.0.dist-info/licenses/LICENSE,sha256=DoyCJUWlDzKbqc5KRbFpsGYLwLh-XJRHKQDoITjb1yc,1083
-aigroup_econ_mcp-0.7.0.dist-info/RECORD,,
+aigroup_econ_mcp-0.8.0.dist-info/METADATA,sha256=7ByVxeiktZPL809uJSH7zKG59f6-1zAzb7uSpxT-Usc,10857
+aigroup_econ_mcp-0.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+aigroup_econ_mcp-0.8.0.dist-info/entry_points.txt,sha256=j5ZJYOc4lAZV-X3XkAuGhzHtIRcJtZ6Gz8ZKPY_QTrM,62
+aigroup_econ_mcp-0.8.0.dist-info/licenses/LICENSE,sha256=DoyCJUWlDzKbqc5KRbFpsGYLwLh-XJRHKQDoITjb1yc,1083
+aigroup_econ_mcp-0.8.0.dist-info/RECORD,,