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 文件。