MCP 服务器

HWP MCP Server

一个 Node.js 服务器，实现了模型上下文协议 (MCP)，用于控制 HWP（韩文文字处理器）文档，从而允许像 Claude 这样的人工智能助手创建和操作韩文文档。 (Alternative, slightly more technical translation): 一个 Node.js 服务器，它实现了模型上下文协议 (MCP)，以便控制 HWP（韩文文字处理器）文档。这使得像 Claude 这样的人工智能助手能够创建和操作韩文文档。

README

HWP-MCP (韩文 Model Context Protocol)

HWP-MCP 是一个 Model Context Protocol (MCP) 服务器，它允许像 Claude 这样的 AI 模型控制韩文文字处理器 (HWP)。这个项目为 AI 提供了自动生成、编辑和操作韩文文档的功能。

主要功能

文档生成和管理：新建文档、打开、保存功能
文本编辑：文本插入、字体设置、段落添加
表格操作：表格生成、数据填充、单元格内容设置
完成文档生成：基于模板的报告和信件自动生成
批量作业：一次执行多个任务的批处理功能

系统要求

Windows 操作系统
韩文 (HWP) 程序安装
Python 3.7 以上
必需的 Python 包 (参考 requirements.txt)

安装方法

克隆存储库:

git clone https://github.com/jkf87/hwp-mcp.git
cd hwp-mcp

安装依赖项:

pip install -r requirements.txt

(可选) 安装 MCP 包:

pip install mcp

使用方法

与 Claude 一起使用

在 Claude 桌面配置文件中，如下注册 HWP-MCP 服务器:

{
  "mcpServers": {
    "hwp": {
      "command": "python",
      "args": ["路径/hwp-mcp/hwp_mcp_stdio_server.py"]
    }
  }
}

主要功能示例

新建文档

hwp_create()

文本插入

hwp_insert_text("请输入您想要的文本。")

表格生成和数据输入

# 表格生成
hwp_insert_table(rows=5, cols=2)

# 表格中填充数据
hwp_fill_table_with_data([
    ["月", "销量"], 
    ["1月", "120"], 
    ["2月", "150"], 
    ["3月", "180"], 
    ["4月", "200"]
], has_header=True)

# 在表格中填充连续数字
hwp_fill_column_numbers(start=1, end=10, column=1, from_first_cell=True)

文档保存

hwp_save("路径/文档名.hwp")

批量作业示例

hwp_batch_operations([
    {"operation": "hwp_create"},
    {"operation": "hwp_insert_text", "params": {"text": "标题"}},
    {"operation": "hwp_set_font", "params": {"size": 20, "bold": True}},
    {"operation": "hwp_save", "params": {"path": "路径/文档名.hwp"}}
])

项目结构

hwp-mcp/
├── hwp_mcp_stdio_server.py  # 主服务器脚本
├── requirements.txt         # 依赖包列表
├── hwp-mcp-结构说明.md       # 项目结构说明文档
├── src/
│   ├── tools/
│   │   ├── hwp_controller.py  # 韩文控制核心控制器
│   │   └── hwp_table_tools.py # 表格相关功能专业模块
│   ├── utils/                 # 实用函数
│   └── __tests__/             # 测试模块
└── security_module/
    └── FilePathCheckerModuleExample.dll  # 安全模块