Wind MCP UI

基于 Wind-Information-Co-Ltd/wind-skills 的 Python 客户端与 UI 示例项目，用于通过 Wind MCP 获取金融数据，并在 Streamlit / xlwings 场景中展示。

功能

• Python Wind MCP client：封装 server_type + api_function + params 调用。
• Streamlit Explorer：网页端填写 WIND_API_KEY、选择 server_type 和 api_function、编辑 params JSON、展示 Table / Parsed / Raw MCP result。
• API Key cookie：网页填写后保存到浏览器 cookie，刷新页面无需重复填写；点击“清除 API Key”会同步删除 cookie。
• Bloomberg 风格主题：样式维护在 demo/streamlit_app.css。
• K线可视化：K线接口使用蜡烛图展示，并动态调整 Y 轴范围、美化 X 轴日期。
• xlwings demo：提供 Excel 工作流可调用的示例函数。

QuickStart in Streamlit

推荐在项目根目录运行：

uv sync
uv run streamlit run demo/streamlit_app.py

不要使用下面这种方式直接运行 Streamlit 文件：

uv run demo/streamlit_app.py

如果误用，程序会提示正确启动命令并退出。

QuickStart in Cherry Studio

装载此文件：wind_mcp_for_cherry_studio.json

API Key

首次打开 Streamlit 页面时填写 WIND_API_KEY。如果还没有 Key，可从 Wind 金融 AI 市场开发者中心获取：

https://aifinmarket.wind.com.cn/#/user/overview

填写后 Key 会保存到当前浏览器 cookie 中，避免每次刷新页面都重新输入。

开发与测试

安装开发依赖：

uv sync --extra dev

运行测试：

uv run --extra dev pytest

运行关键回归测试：

uv run --extra dev pytest tests/test_demo_imports.py tests/test_kline_view.py -q

目录说明

• src/wind_mcp_ui/：Python client、manifest 校验、结果归一化、K线视图工具。
• demo/streamlit_app.py：Streamlit Explorer 主程序。
• demo/streamlit_app.css：Streamlit 页面样式。
• demo/xlwings_demo.py：xlwings 示例函数。
• reference/wind-skills/：Wind 官方 skill 参考文件。
• tests/：单元测试与 demo 回归测试。