HWP-MCP (Protocolo de Contexto Modelo Coreano)

HWP-MCP es un servidor de Protocolo de Contexto de Modelo (MCP) que permite que los modelos de IA como Claude controlen el Procesador de Textos Hangul (HWP). Este proyecto proporciona a la IA la capacidad de crear, editar y manipular automáticamente documentos coreanos.

Características principales

Creación y gestión de documentos: Capacidad de crear, abrir y guardar nuevos documentos
Edición de texto: insertar texto, establecer fuente, agregar párrafos
Trabajar con tablas: crear tablas, rellenarlas con datos y configurar el contenido de las celdas
Cree documentos terminados: genere automáticamente informes y cartas basados en plantillas
Operaciones por lotes: Función por lotes para ejecutar múltiples operaciones a la vez

Requisitos del sistema

Sistema operativo Windows
Instalación del programa Hangul (HWP)
Python 3.7 o posterior
Paquetes de Python necesarios (consulte requirements.txt)

Cómo instalar

Clonar el repositorio:

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

Instalación de dependencias:

pip install -r requirements.txt

(Opcional) Instalar el paquete MCP:

pip install mcp

Cómo utilizar

Para usar con Claude

Registre el servidor HWP-MCP en el archivo de configuración del escritorio de Claude de la siguiente manera:

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

Ejemplos de características clave

Crear un nuevo documento

hwp_create()

Insertar texto

hwp_insert_text("원하는 텍스트를 입력하세요.")

Crear una tabla e ingresar datos

# 테이블 생성
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)

Guardar documento

hwp_save("경로/문서명.hwp")

Ejemplo de operación por lotes

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"}}
])

Estructura del proyecto

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  # 보안 모듈

Solución de problemas

Problemas relacionados con el módulo de seguridad

De forma predeterminada, los programas Hangul muestran una advertencia de seguridad cuando se accede a archivos desde el exterior. Para evitar esto, utilizamos FilePathCheckerModuleExample.dll . Si falla el registro del módulo de seguridad, la función seguirá funcionando, pero puede aparecer un cuadro de diálogo de seguridad al abrir o guardar archivos.

La conexión coreana falló

Si el programa coreano no se está ejecutando, la conexión puede fallar. Asegúrese de que el programa en idioma coreano esté instalado y funcionando correctamente.

Problema de entrada de datos de tabla

Al ingresar datos en una tabla, la posición del cursor a veces se comportaba de manera diferente a la esperada, pero este problema se ha resuelto en la versión actual. Los datos se ingresan con precisión en cada celda de la tabla.

Registro de cambios

27 de marzo de 2025

Capacidades mejoradas de creación de tablas y llenado de datos
- Solucionar el problema con la anidación de tablas dentro de tablas
- Funciones independientes de creación de tablas y llenado de datos
- Se agregó lógica para verificar la posición actual del cursor antes de crear la tabla
- Capacidad mejorada para completar datos solo en tablas existentes
Mejorar la gestión de proyectos
- Agregar archivo .gitignore (excluyendo archivos temporales, archivos de caché, etc.)

25 de marzo de 2025

Funcionalidad de entrada de datos de tabla mejorada
- Los datos se pueden ingresar con precisión a partir de la primera celda
- Selección de celdas mejorada y lógica de posicionamiento del cursor
- Se agregó la capacidad de mantener la posición del cursor al ingresar texto.
Agregar módulo de herramientas de solo tabla ( hwp_table_tools.py )
Agregue la opción from_first_cell a la función hwp_fill_column_numbers

Licencia

Este proyecto se distribuye bajo la licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.

Cómo contribuir

Para informar un problema o sugerir una función: utilice los problemas de GitHub.
Contribuir con código: envíe una solicitud de extracción con sus cambios.

Proyectos relacionados

HWP SDK : SDK oficial de Hangul y computadoras
Cursor MCP
Herrería

contacto

Para consultas relacionadas con el proyecto, comuníquese con Conan a través de GitHub Issues.