DoWhy MCP v2.0

# DoWhy MCP Server - 清理后的项目结构 ## 📁 项目目录结构 ``` dowhy_mcp/ ├── src/ │ └── dowhy_mcp_server/ │ ├── __init__.py │ ├── server.py # MCP 服务器主文件 │ ├── cli.py # 命令行接口 │ ├── tools/ # 因果推断工具 (42个工具) │ │ ├── __init__.py │ │ ├── modeling.py # 因果建模工具 (6个) │ │ ├── estimation.py # 效应估计工具 (12个) │ │ ├── dowhy_native_estimation.py # DoWhy原生估计 │ │ ├── sensitivity.py # 敏感性分析工具 (6个) │ │ ├── discovery.py # 因果发现工具 (3个) │ │ ├── attribution.py # 归因分析工具 (6个) │ │ ├── root_cause.py # 根因分析工具 (5个) │ │ └── counterfactual.py # 反事实分析工具 (6个) │ └── utils/ # 工具函数 │ ├── __init__.py │ ├── data_processor.py # 数据处理和序列化 │ ├── causal_graph.py # 因果图工具 │ └── statistical_utils.py # 安全统计计算 ├── tests/ │ └── test_integration.py # 集成测试 ├── test_data/ # 测试数据 │ ├── data.csv │ ├── data.py │ └── df_i_signupmonth.csv ├── README.md # 项目说明 ├── TOOLS_QUICK_REFERENCE.md # 工具快速参考 ├── TOOLS_DETAILED_GUIDE.md # 工具详细指南 ├── pyproject.toml # 项目配置 ├── uv.lock # 依赖锁定文件 ├── server.py # 服务器启动脚本 ├── mcp.json # MCP 配置 ├── claude_desktop_config.json # Claude Desktop 配置 └── LICENSE # 许可证 ``` ## 🎯 核心特性 ### ✅ 100% DoWhy 原生实现 - 所有因果推断都使用 DoWhy 原生 API - 不包含任何自定义统计计算或"造轮子"实现 - 依赖专业库：causal-learn (因果发现) ### 🔧 完整工具集 (42个工具) 1. **建模工具** (6个): 因果图构建、模型验证 2. **估计工具** (12个): ATE/ATT估计、后门调整、倾向得分等 3. **敏感性分析** (6个): refutation测试、稳定性分析 4. **因果发现** (3个): PC算法、GES算法、FCM发现 5. **归因分析** (6个): Shapley值、路径效应、机制归因 6. **根因分析** (5个): 异常归因、分布变化分析 7. **反事实分析** (6个): 个体/群体反事实、场景分析 ### 🛡️ 专业级质量 - 完整的错误处理和参数验证 - numpy类型序列化支持 - 详细的结果返回和解释 - 支持ATE和ATT估计目标 ## 🚀 使用方式 ### MCP 服务器模式 ```bash python server.py ``` ### Claude Desktop 集成 配置 `claude_desktop_config.json` 后直接在 Claude Desktop 中使用所有42个工具 ## 📊 技术规格 - **DoWhy版本**: 最新稳定版 - **支持的估计方法**: 后门调整、倾向得分、双重稳健、工具变量 - **因果发现**: PC、GES、LiNGAM (通过causal-learn) - **数据格式**: CSV (pandas兼容) - **序列化**: 完整的numpy类型支持 ## 🧹 清理完成 ### 已删除的文件 - ❌ 所有临时测试脚本 (18个文件) - ❌ 备份文件夹 (tools_backup_custom/) - ❌ Python缓存文件 (__pycache__/) - ❌ 多余的文档文件 (5个报告文件) - ❌ 调试和验证脚本 ### 保留的核心文件 - ✅ 核心源代码 (src/dowhy_mcp_server/) - ✅ 42个DoWhy工具 (tools/) - ✅ 工具函数 (utils/) - ✅ 基本测试 (tests/test_integration.py) - ✅ 测试数据 (test_data/) - ✅ 核心文档 (README.md, 工具指南) - ✅ 配置文件 (pyproject.toml, mcp.json等) 项目现在结构清晰，只包含必要的核心文件，所有工具都经过严格测试，确保与DoWhy官方文档一致。