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

Related MCP server: hwpConverMdMCP

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

1. Clonar el repositorio:

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

2. Instalación de dependencias:

pip install -r requirements.txt

3. (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

1. Para informar un problema o sugerir una función: utilice los problemas de GitHub.

2. 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.