hwp-mcp

🚀 HWP - MCP 项目

HWP - MCP 是一个服务器，它能让 AI 模型与韩文（Hancom）文字处理程序进行交互。借助模型上下文协议（Model Context Protocol, 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)
     

✨ 主要特性

• 允许 AI 模型与韩文（Hancom）文字处理程序进行交互。
• 通过模型上下文协议（MCP）实现对韩文文字处理程序的控制。
• 支持文档生成、文本编辑、表格操作等多种功能。
• 可与 Claude 等 AI 模型集成使用。

📦 安装指南

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
     

💻 使用示例

基础用法

from hwp_mcp import Server

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

高级用法

# 这里可根据实际高级使用场景添加说明
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 模块。

贡献方式

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

相关项目

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

联系方式

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

📄 许可证

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