HWP-MCP (Korean Model Context Protocol)
HWP-MCP is a Model Context Protocol (MCP) server that allows AI models such as Claude to control the Hangul Word Processor (HWP). This project provides AI with the ability to automatically create, edit, and manipulate Hangul documents.
Key Features
Document Creation and Management: Ability to create, open, and save new documents
Text editing: insert text, set font, add paragraphs
Working with tables: creating tables, populating them with data, and setting cell content
Create finished documents: Automatically generate template-based reports and letters
Batch operations: Batch function to run multiple operations at once
System Requirements
Windows operating system
Installing Hangul (HWP) program
Python 3.7 or later
Required Python packages (see requirements.txt)
How to install
Clone the repository:
Installing dependencies:
(Optional) Install the MCP package:
How to use
For use with Claude
Register the HWP-MCP server in the Claude desktop settings file as follows:
Key Feature Examples
Create a new document
Insert text
Create a table and enter data
Save document
Batch operation example
Project Structure
Troubleshooting
Security module related issues
By default, Hangul programs display a security warning when accessing files from outside. To bypass this, use the FilePathCheckerModuleExample.dll
module. If the security module registration fails, the function will still work, but a security dialog box may be displayed when opening/saving files.
Korean connection failed
If the Hangul program is not running, the connection may fail. Make sure the Hangul program is installed and operating properly.
Table data entry problem
When entering data into a table, the cursor position sometimes behaved differently than expected, but this issue has been resolved in the current version. Data is entered correctly in all cells of the table.
Change Log
2025-03-27
Improved table creation and data populating capabilities
Fix problem with tables nesting within tables
Separate table creation and data filling functions
Added logic to check current cursor position before creating table
Improved ability to fill in data only in existing tables
Improve project management
Add .gitignore file (excluding temporary files, cache files, etc.)
2025-03-25
Improved table data entry functionality
Data can be entered accurately starting from the first cell
Improved cell selection and cursor positioning logic
Added ability to maintain cursor position when entering text
Add table-only tool module (
hwp_table_tools.py
)Add
from_first_cell
option tohwp_fill_column_numbers
function
License
This project is distributed under the MIT License. See the LICENSE file for details.
How to contribute
To report an issue or suggest a feature: Use GitHub issues.
Contribute code: Submit a Pull Request with your changes.
Related Projects
HWP SDK : Official SDK of Hangul and Computer
contact
For project-related inquiries, please contact Conan through GitHub Issues.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
A Node.js server that implements Model Context Protocol (MCP) for controlling HWP (Korean word processor) documents, allowing AI assistants like Claude to create and manipulate Hangul documents.
Related MCP Servers
- -securityAlicense-qualityNode.js server implementing Model Context Protocol (MCP) for filesystem operations, allowing AI systems to read, write, edit files and manage directories within specified allowed paths.Last updated -135,907MIT License
- -securityAlicense-qualityNode.js server implementing Model Context Protocol (MCP) for filesystem operations with regex support for allowed directories, enabling AI assistants to safely read, write, and manipulate files through natural language.
- -securityAlicense-qualityModel Context Protocol (MCP) server that provides AI assistants with advanced web research capabilities, including Google search integration, intelligent content extraction, and multi-source synthesis.Last updated -114MIT License
- AsecurityFlicenseAqualityA Model Context Protocol (MCP) server that enables AI assistants to perform comprehensive file operations including finding, reading, writing, editing, searching, moving, and copying files with security validations.Last updated -71