hwp-mcp

概述

hwp-mcp是一个基于rhwp引擎构建的专业MCP服务器，提供处理韩文Hangul文档(.hwp/.hwpx)的全面功能。它包含34种工具用于读写操作，包括文档解析、模板填充、文本替换、表格操作、图像提取和渲染为SVG/HTML。该服务器作为rhwp Rust+WASM引擎与AI之间的适配器，使Claude、Cursor和ChatGPT等MCP兼容客户端能通过自然语言操作文档。虽然两种格式都支持读取，但目前仅支持.hwpx写入，对.hwp的写入功能已在计划中。

试试问 AI

装完之后，这里有 7 个你可以让 AI 做的事：

• read_hwp

  Reads HWP document content including text and tables

  试试:Read this HWP document for me试试:What's in this .hwpx file?
• fill_hwp_template

  Fills placeholders in a HWP template

  试试:Fill this HWP template with {{name}}=John, {{company}}=Acme Corp试试:Replace the placeholders in this form
• replace_hwp_text

  Replaces text in a HWP document

  试试:Replace 'AI' with 'Artificial Intelligence' in this document试试:Change all instances of 'old company name' to 'new company name'
• get_hwp_info

  Retrieves metadata and statistics about a HWP document

  试试:Tell me about this HWP document试试:How many pages are in this file?
• render_hwp_page

  Renders a specific HWP page as SVG

  试试:Convert page 1 of this HWP to SVG试试:Show me the first page visually
• list_hwp_images

  Lists all embedded images in a HWP document

  试试:What images are in this HWP file?试试:Extract all images from this document
• set_hwp_paragraph_text

  Replaces the entire text of a specific paragraph

  试试:Replace the text of paragraph 3试试:Change the introduction paragraph
• insert_hwp_image

  Inserts a new image into a HWP document

  试试:Add this logo image to the document试试:Insert image at the beginning
• create_hwpx_document

  Creates a new HWPX document with text content

  试试:Create a new HWPX document with this text试试:Generate a blank document
• read_hwp_tables

  Extracts tables from a HWP document as markdown

  试试:Get all tables from this HWP试试:Extract the first table as markdown
• set_hwp_cell_text

  Sets text in a specific table cell

  试试:Set the text in row 2, column 3试试:Update the value in this table cell
• append_hwp_paragraph

  Adds a new paragraph to the end of a HWP document

  试试:Add a conclusion paragraph at the end试试:Append this text to the document

可对比工具

安装

claude mcp add hwp-mcp -- npx -y hwp-mcp

{
  "mcpServers": {
    "hwp-mcp": {
      "command": "npx",
      "args": ["-y", "hwp-mcp"]
    }
  }
}

FAQ

支持哪些文档格式？

读取支持.hwp和.hwpx两种格式。写入目前仅支持.hwpx，对.hwp的写入支持已在v0.3计划中。

我可以将此用于除Claude之外的AI助手吗？

是的，hwp-mcp兼容任何支持MCP服务器的客户端，包括Cursor、ChatGPT等。

它是否支持图表和书签等复杂文档功能？

这些功能尚未实现。当前覆盖率约为85%，主要功能如.hwp写入支持、图表和样式定义已在v0.3计划中。

hwp-mcp 对比