海尔云文档 MCP Server

一个用于在 Kiro 中访问海尔云文档的 MCP 服务器，支持 Hwork 云文档和飞书文档，支持自动登录和内容提取。

✨ 功能特性

• 🔐 自动登录管理：首次使用时打开浏览器窗口供用户登录，登录状态自动保存
• 📄 支持多种文档：
  • Hwork 云文档（docs.hwork.haier.net）- Word 文档
  • 飞书文档（ihaier.feishu.cn）
• 💾 会话持久化：登录状态保存在本地，后续请求无需重复登录
• 🎯 智能模式切换：首次登录显示窗口，后续使用无头模式（后台运行）

⚠️ 限制说明

• ❌ Hwork 暂不支持表格、多维表格

📦 安装与配置

在 .kiro/settings/mcp.json 中添加以下配置：

{
  "mcpServers": {
    "haier-cloud-docs": {
      "command": "npx",
      "args": ["-y", "haier-cloud-docs"],
      "disabled": false,
      "autoApprove": ["fetch_cloud_doc"]
    }
  }
}

保存后重启 Kiro 或重新连接 MCP 服务器。

首次使用时，npx 会自动下载包，可能需要等待几秒钟。

🚀 使用

在 Kiro 中直接发送文档链接：

Hwork 文档：

https://docs.hwork.haier.net/weboffice/l/xxxxx

飞书文档：

https://ihaier.feishu.cn/docx/xxxxx

首次使用会弹出浏览器窗口供登录，后续自动使用保存的登录状态。

📚 文档

• 开发指南 - 工作原理、技术实现、开发说明

📝 注意事项

• 登录状态保存在 ~/.haier-cloud-docs/ 目录下
• 首次登录使用窗口模式，后续使用无头模式
• 如遇到内容提取不完整，可尝试增加 timeout 参数
• 支持的域名：
  • docs.hwork.haier.net - Hwork 云文档
  • ihaier.feishu.cn - 飞书文档