MCPサーバー

AIエージェントに韓国語文書を読ませる

MCPとは？

Model Context Protocol（MCP）はAIアシスタントが外部ツールを使用できるようにするオープンスタンダードです。hwpx.io MCPサーバーはAIにHWP/HWPX文書の読み取りと変換の能力を提供します。

インストール

グローバルインストール:

npm install -g @hwpxio/mcp-server

またはnpxでインストールなしで直接実行できます。

設定

AIツールのMCP設定にサーバーを追加します。

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "hwpxio": {
      "command": "npx",
      "args": ["-y", "@hwpxio/mcp-server"],
      "env": {
        "HWPXIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "hwpxio": {
      "command": "npx",
      "args": ["-y", "@hwpxio/mcp-server"],
      "env": {
        "HWPXIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add hwpxio -- npx -y @hwpxio/mcp-server

利用可能なツール

read_hwpx

.hwpxファイルを読み取り、Markdownテキストとして返します。

read_hwp

.hwpファイルを読み取り、Markdownテキストとして返します。

convert

.hwp/.hwpxファイルをMarkdownまたはHTMLに変換してディスクに保存します。

read_directory

ディレクトリ内のすべてのHWP/HWPXファイルを一括で読み取ります。

リモートMCP

ホスティングされたエンドポイントを通じてローカルインストールなしで接続します。AIクライアントがリモートMCP URLをサポートしている場合に利用可能です。

https://hwpx.io/api/v1/mcp

活用シナリオ

プレスリリースの要約

"ダウンロードフォルダのhwpxファイルを読んで要点をまとめて。"

フォルダ一括変換

"documents/フォルダのすべてのHWPファイルをMarkdownに変換して。"