feat(hy3-mcp-data-analysis): 提交基于 Tencent Hunyuan Hy3 的数据分析 MCP Server (Rhinobird 2026 #3)

[ilovecplusplus230]

关联 Issue

Closes #3 (#3)

项目简介

Hy3 MCP Data Analysis Server（hy3-mcp-data-analysis）是一个基于 Model Context Protocol (https://modelcontextprotocol.io) 的本地 stdio MCP Server。它调用 腾讯混元 Hy3 API，把 CSV / JSON
等结构化数据转化为统计分析报告和可视化图表方案，并内置网络搜索能力辅助分析。

使用 MCP Python SDK（FastMCP）实现，pip install 即可运行，支持 CodeBuddy、Cursor、Cline、Roo Code 等客户端即插即用。

核心功能

• 4 个 MCP 工具，覆盖数据加载 → 搜索 → 分析 → 图表全流程
• load_dataset：读取 CSV / JSON / JSONL，输出字段信息、数值统计（min/max/mean/std）和数据预览
• web_search：Tavily API 优先 → DuckDuckGo 自动回退，无 Key 也能搜索
• hy3_analyze：Hy3 深度推理（reasoning_effort=high），输出结构化中文分析报告（关键发现 / 趋势 / 异常点 / 统计结论 / 建议）
• hy3_chart_guide：Hy3 根据数据特征自动推荐图表类型、轴映射和预处理方案，并生成可执行的 matplotlib / plotly Python 绘图代码
• 路径安全：HY3_MCP_ROOT 沙箱 + 隐藏目录遍历防护
• 优雅降级：搜索双后端自动回退，网络不可用时不影响纯数据分析

安装与验证

cd issue3
pip install -r requirements.txt
cp .env.example .env # 填入 HY3_API_KEY
python smoke_test.py # 直接函数测试
python mcp_client_check.py # MCP 协议端到端测试

验证结果：

• smoke_test.py：10 / 10 通过（含越界拒绝、格式拒绝、DDG 搜索、Hy3 分析）
• mcp_client_check.py：4 个 tools 全部发现并通过 stdio JSON-RPC 调用，最终输出 PASS

客户端配置

已提供 MCP 客户端配置示例，位于 issue3/examples/：

┌─────────────────────────┬────────────────────────────┐
│ 文件 │ 客户端 │
├─────────────────────────┼────────────────────────────┤
│ cline_mcp_settings.json │ Cline (VS Code) │
├─────────────────────────┼────────────────────────────┤
│ cursor-mcp.json │ Cursor IDE │
├─────────────────────────┼────────────────────────────┤
│ codebuddy-mcp.json │ CodeBuddy / WorkBuddy │
├─────────────────────────┼────────────────────────────┤
│ mcp-inspector.md │ MCP Inspector 官方调试工具 │
└─────────────────────────┴────────────────────────────┘

RhinoBird 2026 提交清单

• 基于 Hy3 的 MCP Server
• 至少 3 个 tool（实际 4 个：load_dataset / web_search / hy3_analyze / hy3_chart_guide）
• 外部数据源 / 工具（Tavily + DuckDuckGo 双后端网络搜索）
• 本地 stdio 模式（FastMCP，无需公网部署）
• 不硬编码 API Key（全通过 .env / 环境变量注入）
• 在 2+ 个 MCP 客户端验证（MCP Inspector + 命令行 mcp_client_check.py + Cline / Cursor / CodeBuddy 配置示例）
• 一键安装（pip install -r requirements.txt + .env 配置即可）
• 完整 README、演示指引与客户端配置示例