Hwp MCP

🚀 HWP - MCP プロジェクト紹介

HWP - MCP は、AI モデルが韓国語（Hancom）のワードプロセッサとやり取りできるサーバーです。モデルコンテキストプロトコル（Model Context Protocol, MCP）を通じて韓国語のワードプロセッサを制御し、ドキュメント生成、テキスト編集、表操作などの多様な機能をサポートしています。

🚀 クイックスタート

HWP - MCP は、AI モデルと韓国語のワードプロセッサを連携させることができます。以下に、システム要件、インストール方法、使用例などの詳細を説明します。

✨ 主な機能

• AI モデルと韓国語（Hancom）のワードプロセッサを連携させることができます。
• モデルコンテキストプロトコル（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 モデルと統合して使用できます。以下は具体的な設定とコード例です。

Claude との統合

• config.json ファイルに以下の内容を追加します。

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

コード例

• 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 チャンネル 코난쌤 を通じてお問い合わせください。