产品定位
HWP-MCP是一个专为AI设计的韩语文档处理工具,通过MCP协议实现AI对HWP文档的自动化操作。
核心功能
- 文档生成及管理:创建、打开、保存文档
- 文本编辑:插入文本、设置字体、添加段落
- 表格操作:创建表格、填充数据、设置单元格内容
- 文档生成:基于模板自动生成报告和信件
- 批量操作:支持一次性执行多个操作的批处理功能
适用场景
- 自动化生成韩语报告和文档
- 批量处理HWP文档
- AI辅助的文档编辑和格式化
工具列表
hwp_controller.py
: 韩语文档控制核心工具hwp_table_tools.py
: 表格操作专用工具
常见问题解答
- 安全模块问题:HWP程序在外部文件访问时会显示安全警告,可使用
FilePathCheckerModuleExample.dll
模块绕过。 - HWP连接失败:确保HWP程序已安装并正常运行。
- 表格数据输入问题:当前版本已解决表格数据输入时的光标位置问题。
使用教程
使用依赖
- Windows操作系统
- 韩语HWP程序
- Python 3.7+
- 安装依赖包:
bash
pip install -r requirements.txt
安装教程
- 克隆仓库:
bash
git clone https://github.com/jkf87/hwp-mcp.git
cd hwp-mcp - 安装MCP包(可选):
bash
pip install mcp
调试方式
- 在Claude配置文件中注册HWP-MCP服务器:
json
{
"mcpServers": {
"hwp": {
"command": "python",
"args": ["路径/hwp-mcp/hwp_mcp_stdio_server.py"]
}
}
} - 使用示例命令测试功能:
python
hwp_create()
hwp_insert_text("测试文本")
hwp_save("测试文档.hwp")