H-work 云文档 MCP Server

一个用于在 Kiro 中访问 H-work 云文档的 MCP 服务器，支持自动登录和内容提取。

✨ 功能特性

• 🔐 自动登录管理：首次使用时打开浏览器窗口供用户登录，登录状态自动保存
• 📄 支持 Word 文档：完整提取 H-work Word 文档内容
• 💾 会话持久化：登录状态保存在本地，后续请求无需重复登录
• 🎯 智能模式切换：首次登录显示窗口，后续使用无头模式（后台运行）

⚠️ 限制说明

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

📦 安装与配置

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

{
  "mcpServers": {
    "hwork-docs": {
      "command": "npx",
      "args": ["-y", "@haier/mcp-hwork-docs"],
      "disabled": false,
      "autoApprove": ["fetch_hwork_doc"]
    }
  }
}

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

首次使用时，npx 会自动下载包和浏览器（约 300MB），可能需要等待几分钟。

🚀 使用

在 Kiro 中直接发送 H-work 文档链接：

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

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

📚 文档

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

📝 注意事项

• 登录状态保存在 ~/.mcp-hwork-docs/ 目录下
• 首次登录使用窗口模式，后续使用无头模式
• 如遇到内容提取不完整，可尝试增加 timeout 参数