HWP MCP Server
HWP-MCP(韩国模型上下文协议)
HWP-MCP 是一个模型上下文协议 (MCP) 服务器,允许 Claude 等 AI 模型控制韩文文字处理器 (HWP)。该项目为AI提供了自动创建、编辑和操作韩语文档的能力。
主要特点
文档创建和管理:能够创建、打开和保存新文档
文本编辑:插入文本、设置字体、添加段落
使用表格:创建表格、填充数据以及设置单元格内容
创建完成的文档:自动生成基于模板的报告和信函
批量操作:批量功能可同时运行多个操作
Related MCP server: hwpConverMdMCP
系统要求
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 # 보안 모듈故障排除
安全模块相关问题
默认情况下,韩语程序在从外部访问文件时会显示安全警告。为了绕过这个问题,我们使用FilePathCheckerModuleExample.dll模块。如果安全模块注册失败,该功能仍然可以工作,但在打开/保存文件时可能会出现安全对话框。
韩语连接失败
如果韩语程序没有运行,连接可能会失败。确保韩语程序已安装并正常运行。
表格数据录入问题
在表中输入数据时,光标位置有时表现与预期不同,但该问题已在当前版本中得到解决。数据被准确地输入到表格中的每个单元格中。
更改日志
2025年3月27日
改进的表格创建和数据填充功能
修复表格嵌套在表格中的问题
单独的表格创建和数据填充功能
添加了在创建表之前检查当前光标位置的逻辑
改进了仅在现有表中填写数据的能力
改进项目管理
添加.gitignore文件(排除临时文件、缓存文件等)
2025年3月25日
改进的表格数据输入功能
从第一个单元格开始即可准确输入数据
改进的单元格选择和光标定位逻辑
增加了输入文本时保持光标位置的功能
添加仅表格工具模块(
hwp_table_tools.py)将
from_first_cell选项添加到hwp_fill_column_numbers函数
执照
该项目根据 MIT 许可证分发。请参阅LICENSE文件以了解详细信息。
如何贡献
要报告问题或建议功能:使用 GitHub 问题。
贡献代码:提交包含您更改的 Pull 请求。
相关项目
接触
如有项目相关疑问,请通过 GitHub Issues 联系Conan 。
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables comprehensive control of Hangul (HWP) documents through an MCP server, supporting operations from basic document management to advanced formatting, tables, images, and document structure manipulation.6
- FlicenseAqualityDmaintenanceAn MCP server that enables LLMs to convert HWP and HWPX documents into Markdown for analysis and processing. It supports document conversion via local file paths or Base64 content across various MCP-compatible clients.2
- FlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that enables AI models to control Hancom Office Hanword (HWP) documents on Windows. It allows for the automated creation, editing, and management of Korean word processor files, including text formatting and table manipulation.
- AlicenseAqualityAmaintenanceAn MCP server for reading, writing, and managing Korean Hangul Word Processor (HWP/HWPX) files. It allows users to extract content, fill templates, and create new documents directly through AI assistants.3424880MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jkf87/hwp-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server