HWP-MCP 项目简介

HWP-MCP 是一个允许 AI 模型与韩文（Hancom）文字处理程序进行交互的服务器。它通过模型上下文协议（Model Context Protocol, MCP）实现了对韩文文字处理程序的控制，支持多种功能包括文档生成、文本编辑、表格操作等。

系统要求

• 操作系统：需要安装并运行 Windows 操作系统。
• 软件依赖：必须安装 Hancom 的 HWP 文字处理程序。
• Python 版本：推荐使用 Python 3.8 或更高版本。

安装指南

1. 克隆存储库：
   • 打开终端，运行以下命令：

     git clone https://github.com/your-repository/hwp-mcp.git
     

2. 安装依赖项：
   • 使用 pip 进行安装：

     cd hwp-mcp
     pip install -r requirements.txt
     

3. 可选安装 HWP-MCP 包：
   • 如果需要，运行以下命令：

     pip install hwp-mcp
     

使用说明

HWP-MCP 可以与 Claude 等 AI 模型集成使用。以下是具体的配置和示例：

1. Claude 集成：
   • 在 config.json 文件中添加以下内容：

     {
       "model": "claude",
       "context_protocol": "mcp"
     }
     

2. 代码示例：
   • 初始化 HWP-MCP 服务器并连接到 Claude 模型：

     from hwp_mcp import Server
     
     server = Server()
     server.connect("claud-ai.com", 1234)
     

项目结构

hwp-mcp/
├── hwp_table_tools.py        # 表格操作专用工具模块
├── config.json                # 配置文件示例
└── requirements.txt           # 依赖项列表

故障排除

1. 安全模块问题：
   • 如果遇到安全对话框，请确保 HWP 文字处理程序已正确安装并运行。
2. 连接失败：
   • 确认 Hancom HWP 文字处理程序是否已启动且正常工作。
3. 表格数据输入异常：
   • 检查当前光标位置是否正确，确保没有其他干扰因素。

变更日志

2025-03-27

• 表格功能改进：
  • 解决了嵌套表的问题。
  • 分离表格创建与数据填充逻辑。
  • 添加当前位置检查机制。
• 项目管理优化：
  • 更新 .gitignore 文件，排除临时和缓存文件。

2025-03-25

• 表格功能增强：
  • 支持从第一个单元格开始输入数据。
  • 优化单元格选择与光标定位逻辑。
  • 添加文本输入后光标位置保持功能。
• 新增 hwp_table_tools.py 模块。

许可证

本项目遵循 MIT 许可证，具体内容请参阅 LICENSE 文件。

贡献方式

1. 问题报告与功能建议：
   • 通过 GitHub Issues 提交问题或建议。
2. 代码贡献：
   • 提交包含修改内容的 Pull Request。

相关项目

• HWP SDK：Hancom 官方提供的 SDK。
• Cursor MCP
• Smithery

联系方式

如有任何问题，请通过 GitHub Issues 或 YouTube 频道 코난쌤 联系我们。