claude-code-hwp-mcp 0.3.1 → 0.5.1

package/README.md

@@ -2,7 +2,7 @@
 
 Claude Code와 Claude Desktop에서 한글(HWP) 문서를 AI로 자동 편집하는 MCP 서버입니다.
 
-85개 이상의 도구로 문서 열기, 표 채우기, 텍스트 편집, 서식 설정, PDF 변환까지 모두 자동화할 수 있습니다.
+94개 도구로 문서 열기, 표 채우기, 텍스트 편집, 서식 설정, 페이지 레이아웃, PDF 시각 검증까지 모두 자동화할 수 있습니다.
 
 > Windows 전용 | 한글 2014 이상 | Python 3.8+ | Claude Code + Claude Desktop 지원
 
@@ -299,7 +299,7 @@ Python 경로, pyhwpx 설치 여부, 한글 프로그램 설치 및 실행 상
 
 ---
 
-## 기능 목록 (85개+)
+## 기능 목록 (94개)
 
 ### 환경/문서 관리 (6개)
 
@@ -379,16 +379,30 @@ Python 경로, pyhwpx 설치 여부, 한글 프로그램 설치 및 실행 상
 | hwp_set_cell_color | 셀 배경색 설정 |
 | hwp_set_table_border | 표 테두리 스타일 설정 |
 
-### 이미지/레이아웃 (5개)
+### 페이지/레이아웃 (9개)
 
 | 도구 | 설명 |
 |------|------|
+| hwp_set_page_setup | 여백, 용지 크기, 방향(가로/세로) 설정 |
+| hwp_set_header_footer | 머리글/바닥글 삽입 |
+| hwp_set_column | 다단 설정 (2단/3단, 구분선) |
+| hwp_verify_layout | PDF→PNG 시각 검증 (PyMuPDF) |
 | hwp_insert_picture | 이미지 삽입 |
 | hwp_set_background_picture | 배경 이미지 설정 |
 | hwp_insert_line | 선(줄) 삽입 |
 | hwp_break_section | 섹션 나누기 |
 | hwp_break_column | 다단 나누기 |
 
+### 서식/그리기 (5개)
+
+| 도구 | 설명 |
+|------|------|
+| hwp_apply_style | 문단 스타일 적용 ("제목1", "본문" 등) |
+| hwp_set_cell_property | 셀 여백/수직정렬/텍스트방향/보호 |
+| hwp_insert_textbox | 글상자 생성 (위치/크기 지정) |
+| hwp_draw_line | 선 그리기 (두께/색상/스타일) |
+| hwp_insert_caption | 표/그림 캡션 삽입 |
+
 ### 스마트/복합 도구 (16개)
 
 | 도구 | 설명 |
@@ -520,38 +534,66 @@ HWP 바이너리 파일에서 `hwp_text_search`가 0건을 반환할 수 있습
 
 ---
 
-## v0.3.0 변경사항
-
-### 버그 수정 (10건)
-
+## 변경 이력
+
+### v0.5.0 (2026-03-25) — 94개 도구, 표 서식 대폭 강화
+
+**신규 도구 9개:**
+- `hwp_set_page_setup` — 여백, 용지 크기, 방향(가로/세로) 설정
+- `hwp_set_header_footer` — 머리글/바닥글 삽입 (CreateAction 방식, 대화상자 없음)
+- `hwp_set_column` — 다단 설정 (2단/3단, 구분선)
+- `hwp_verify_layout` — PDF→PNG 시각 검증 (PyMuPDF 필요)
+- `hwp_apply_style` — 문단 스타일 적용 ("제목1", "본문" 등)
+- `hwp_set_cell_property` — 셀 여백/수직정렬/텍스트방향/보호
+- `hwp_insert_textbox` — 글상자 생성 (위치/크기 지정)
+- `hwp_draw_line` — 선 그리기 (두께/색상/스타일)
+- `hwp_insert_caption` — 표/그림 캡션 삽입
+
+**텍스트 서식 속성 25+ 추가 (insert_text):**
+- 밑줄: underline_type(7종), underline_color
+- 취소선: strikeout_type(4종), strikeout_color
+- 효과: superscript, subscript, outline, shadow, emboss, engrave, small_caps
+- 글꼴: font_name_latin(라틴 전용), shadow_color, use_kerning
+- 배경: bg_color
+
+**문단 서식 속성 11개 추가 (set_paragraph_style):**
+- page_break_before, keep_with_next, widow_orphan
+- line_wrap, snap_to_grid, auto_space_eAsian_eng/num
+- break_latin_word, heading_type, keep_lines_together, condense
+
+**표 기능 핵심 개선:**
+- 셀 배경색: pyhwpx `cell_fill()` 내장 메서드 사용 (안정적)
+- 셀 텍스트 정렬: `TableCellAlignCenterCenter` 액션 사용 (삽입 후 적용)
+- 셀 병합: `TableCellBlockExtend` 방식으로 정확한 블록 선택
+- 표 생성: col_widths(mm), row_heights(mm), alignment(left/center/right), header_style(Bold)
+- 테두리: color(#RRGGBB), edges(방향별 적용) 지원
+
+**버그 수정:**
+- insert_text 자동 줄바꿈 — 각 호출이 독립 문단으로 생성
+- set_header_footer: `CreateAction("HeaderFooter")` 방식 (대화상자 타임아웃 해결)
+- apply_style: `Execute("Style")` + `SetItem("StyleName")` (대화상자 방지)
+- draw_line: 대화형 InsertLine fallback 제거
+- insert_footnote/endnote: try/except + CloseEx 추가
+- get_cursor_context: page → total_pages + current_page(KeyIndicator)
+
+### v0.3.0 — HWPX XML 라우팅 + 10건 버그 수정
+
+**버그 수정 (10건):**
 - SelectAll 문서 파괴 수정 (table_create_from_data, gantt_chart 등)
 - find_replace 전후 텍스트 비교 검증으로 개선
 - text_search 선택 영역 기반 판단으로 개선
 - find_and_append 커서 유실 수정 (Cancel → MoveRight)
 - 버퍼 오버플로우 시 개별 요청만 거부
 - XHwpMessageBoxMode 복원 (close_document)
-- insert_markdown 표 파싱 추가
 - blank_template.hwpx 프로그래밍적 생성 (파일 의존성 제거)
-- except pass → stderr 로깅 변환
-- MAX_TABLES scanned_tables 필드 분리
-
-### HWPX XML 라우팅
-
-HWPX 파일의 텍스트 검색/치환을 Node.js XML 엔진으로 직접 처리:
-- hwp_find_replace → XML replaceTextInSection
-- hwp_find_replace_multi → XML 루프 치환
-- hwp_find_replace_nth → XML N번째 치환
-- hwp_find_and_append → XML findAndAppend
-- hwp_text_search → XML searchTextInSection
-
-XML 실패 시(파일 잠금 등) COM 경로로 자동 폴백.
 
-### 환경 진단 개선
+**HWPX XML 라우팅:**
+- HWPX 파일의 텍스트 검색/치환을 Node.js XML 엔진으로 직접 처리
+- XML 실패 시(파일 잠금 등) COM 경로로 자동 폴백
 
+**환경 진단 개선:**
 - Microsoft Store Python 자동 감지 + 경고
 - 한글 프로세스 실행 여부 체크 (tasklist)
-- Python 실행 경로 표시
-- postinstall 스크립트 ESM 호환
 
 ---
 

package/dist/hwp-bridge.js

@@ -289,23 +289,28 @@ export class HwpBridge {
             };
             return result;
         }
-        // 3) 한글(HWP) COM 등록 체크
+        // 3) 한글(HWP) 설치 체크 — COM Dispatch 대신 파일 존재 + pyhwpx import 확인
+        // (COM Dispatch는 빈 한글 문서를 열어버리는 부작용이 있으므로 제거)
         try {
-            await execFileAsync(pythonExe, ['-c', 'import win32com.client; o = win32com.client.gencache.EnsureDispatch("HWPFrame.HwpObject"); o.XHwpDocuments.Close(False); del o'], { timeout: 15000 });
-            result.hwp = { found: true };
-        }
-        catch (err) {
-            const msg = err.message || '';
-            if (msg.includes('COM class not registered') || msg.includes('gencache')) {
-                result.hwp = {
-                    found: false,
-                    guide: '한글(HWP) 프로그램이 설치되지 않았습니다.\n→ 한컴오피스 한글 설치 필요 (한글 2014 이상)\n→ 설치 후 한글을 한번 실행하여 초기 설정 완료',
-                };
+            const { stdout } = await execFileAsync(pythonExe, ['-c',
+                'import os; paths = [r"C:\\Program Files\\Hancom", r"C:\\Program Files (x86)\\Hancom"]; ' +
+                    'found = any(os.path.isdir(p) for p in paths); ' +
+                    'print("installed" if found else "not_found")'
+            ], { timeout: 5000 });
+            if (stdout.trim() === 'installed') {
+                result.hwp = { found: true };
             }
             else {
-                result.hwp = { found: true };
+                // 폴더가 없어도 pyhwpx가 COM을 찾을 수 있으므로 pyhwpx import 성공이면 OK
+                result.hwp = { found: true, guide: '한컴 설치 폴더를 찾을 수 없지만, pyhwpx가 설치되어 있으므로 동작할 수 있습니다.' };
             }
         }
+        catch {
+            result.hwp = {
+                found: false,
+                guide: '한글(HWP) 프로그램이 설치되지 않았습니다.\n→ 한컴오피스 한글 설치 필요 (한글 2014 이상)\n→ 설치 후 한글을 한번 실행하여 초기 설정 완료',
+            };
+        }
         // 4) 한글 프로세스 실행 여부 체크
         try {
             const { stdout } = await execFileAsync('tasklist', ['/FI', 'IMAGENAME eq Hwp.exe', '/NH'], { timeout: 5000 });

package/dist/index.js

@@ -19,8 +19,8 @@ const resolvedToolset = validToolsets.includes(toolset)
     : 'standard';
 const bridge = new HwpBridge();
 const server = new McpServer({
-    name: 'claude-code-hwp-mcp',
-    version: '0.3.1',
+    name: 'hwp-studio',
+    version: '0.4.1',
 });
 setupServer(server, bridge, resolvedToolset);
 const transport = new StdioServerTransport();

package/dist/tools/analysis-tools.js

@@ -428,5 +428,188 @@ export function registerAnalysisTools(server, bridge, toolset = 'standard') {
                 return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
             }
         });
+        // ── 시각적 레이아웃 검증 ──
+        server.tool('hwp_verify_layout', '현재 문서를 PNG 이미지로 변환하여 경로를 반환합니다. Claude가 Read 도구로 이미지를 읽어 표 구조, 셀 병합, 열 너비, 정렬 등을 시각적으로 검증합니다. 공문서 생성 후 결과물 확인에 사용하세요. PyMuPDF 필요(pip install PyMuPDF).', {
+            pages: z.string().optional().describe('확인할 페이지 (예: "1", "5-7". 생략 시 전체)'),
+        }, async ({ pages }) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const params = {};
+                if (pages)
+                    params.pages = pages;
+                const r = await bridge.send('verify_layout', params, 60000);
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 페이지 설정 ──
+        server.tool('hwp_set_page_setup', '페이지 여백, 용지 크기, 방향을 설정합니다. 공문서 작성 전 페이지 설정에 사용하세요.', {
+            top_margin: z.number().optional().describe('위쪽 여백 (mm)'),
+            bottom_margin: z.number().optional().describe('아래쪽 여백 (mm)'),
+            left_margin: z.number().optional().describe('왼쪽 여백 (mm)'),
+            right_margin: z.number().optional().describe('오른쪽 여백 (mm)'),
+            header_margin: z.number().optional().describe('머리말 여백 (mm)'),
+            footer_margin: z.number().optional().describe('꼬리말 여백 (mm)'),
+            orientation: z.enum(['portrait', 'landscape']).optional().describe('용지 방향'),
+            paper_width: z.number().optional().describe('용지 너비 (mm, 기본 A4=210)'),
+            paper_height: z.number().optional().describe('용지 높이 (mm, 기본 A4=297)'),
+        }, async (params) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('set_page_setup', params);
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 셀 속성 설정 ──
+        server.tool('hwp_set_cell_property', '표 셀의 여백, 수직 정렬, 텍스트 방향, 보호 등 속성을 설정합니다.', {
+            table_index: z.number().int().min(0).describe('표 인덱스'),
+            tab: z.number().int().min(0).describe('셀 탭 인덱스'),
+            vert_align: z.enum(['top', 'middle', 'bottom']).optional().describe('수직 정렬'),
+            margin_left: z.number().optional().describe('셀 왼쪽 여백 (mm)'),
+            margin_right: z.number().optional().describe('셀 오른쪽 여백 (mm)'),
+            margin_top: z.number().optional().describe('셀 위쪽 여백 (mm)'),
+            margin_bottom: z.number().optional().describe('셀 아래쪽 여백 (mm)'),
+            text_direction: z.number().int().min(0).max(1).optional().describe('텍스트 방향 (0=가로, 1=세로)'),
+            protected: z.boolean().optional().describe('셀 보호'),
+        }, async (params) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('set_cell_property', params);
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 글상자 생성 ──
+        server.tool('hwp_insert_textbox', '글상자(텍스트박스)를 생성합니다. x/y로 위치, width/height로 크기를 지정합니다. 결재란 등 위치 지정이 필요한 요소에 사용하세요.', {
+            x: z.number().optional().describe('X 위치 (mm, 페이지 기준, 기본 0)'),
+            y: z.number().optional().describe('Y 위치 (mm, 페이지 기준, 기본 0)'),
+            width: z.number().optional().describe('너비 (mm, 기본 60)'),
+            height: z.number().optional().describe('높이 (mm, 기본 30)'),
+            text: z.string().optional().describe('글상자 내 텍스트'),
+            border: z.boolean().optional().describe('테두리 표시 (기본 true)'),
+        }, async (params) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('insert_textbox', params);
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 선 그리기 (강화) ──
+        server.tool('hwp_draw_line', '선을 그립니다. 두께, 색상, 스타일을 지정할 수 있습니다. hwp_insert_line보다 상세한 제어가 가능합니다.', {
+            width: z.number().optional().describe('선 두께'),
+            color: z.string().optional().describe('선 색상 (#RRGGBB 또는 [R,G,B])'),
+            style: z.number().int().min(0).max(5).optional().describe('선 스타일 (0=실선, 1=파선, 2=점선, 3=1점쇄선, 4=2점쇄선)'),
+        }, async (params) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('draw_line', params);
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 머리글/바닥글 ──
+        server.tool('hwp_set_header_footer', '머리글 또는 바닥글을 설정합니다. 기관명, 페이지번호 등을 삽입할 때 사용하세요.', {
+            type: z.enum(['header', 'footer']).describe('머리글 또는 바닥글'),
+            text: z.string().optional().describe('삽입할 텍스트'),
+        }, async ({ type, text }) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('set_header_footer', { type, text });
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 스타일 적용 ──
+        server.tool('hwp_apply_style', '현재 커서 위치에 문단 스타일을 적용합니다. "제목1", "본문", "개요1" 등 한글에 정의된 스타일을 사용합니다.', {
+            style_name: z.string().describe('스타일 이름 (예: "제목1", "본문", "개요 1")'),
+        }, async ({ style_name }) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('apply_style', { style_name });
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 다단 설정 ──
+        server.tool('hwp_set_column', '현재 섹션의 다단을 설정합니다. 2단/3단 레이아웃에 사용하세요.', {
+            count: z.number().int().min(1).max(10).describe('단 수 (기본 2)'),
+            gap: z.number().optional().describe('단 간격 (mm, 기본 10)'),
+            line_type: z.number().int().min(0).max(5).optional().describe('구분선 종류 (0=없음, 1=실선)'),
+        }, async ({ count, gap, line_type }) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('set_column', { count, gap, line_type });
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        // ── 캡션 삽입 ──
+        server.tool('hwp_insert_caption', '표나 그림에 캡션(제목)을 삽입합니다.', {
+            text: z.string().optional().describe('캡션 텍스트'),
+            side: z.number().int().min(0).max(3).optional().describe('캡션 위치 (0=왼쪽, 1=오른쪽, 2=위, 3=아래)'),
+        }, async ({ text, side }) => {
+            if (!bridge.getCurrentDocument())
+                return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
+            try {
+                await bridge.ensureRunning();
+                const r = await bridge.send('insert_caption', { text, side });
+                if (!r.success)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
+                return { content: [{ type: 'text', text: JSON.stringify(r.data) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
     } // end toolset !== 'minimal'
 }

package/dist/tools/editing-tools.js

@@ -53,7 +53,9 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
                     font_name: z.string().optional().describe('글꼴 이름'),
                     char_spacing: z.number().optional().describe('자간 (%)'),
                     width_ratio: z.number().optional().describe('장평 (%)'),
+                    align: z.enum(['left', 'center', 'right', 'justify']).optional().describe('셀 텍스트 정렬'),
                 }).optional().describe('셀별 서식 (생략 시 기존 셀 서식 상속)'),
+                vert_align: z.enum(['top', 'middle', 'bottom']).optional().describe('셀 수직 정렬'),
             })).describe('채울 셀 목록. label, tab, row+col 중 하나 필수'),
         })).describe('채울 표 배열'),
     }, async ({ file_path, tables }) => {
@@ -81,7 +83,7 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
                 if (tabCells.length > 0) {
                     const resp = await bridge.send('fill_by_tab', {
                         table_index: table.index,
-                        cells: tabCells.map(c => ({ tab: c.tab, text: c.text, ...(c.style ? { style: c.style } : {}) })),
+                        cells: tabCells.map(c => ({ tab: c.tab, text: c.text, ...(c.style ? { style: c.style } : {}), ...(c.vert_align ? { vert_align: c.vert_align } : {}) })),
                     }, FILL_TIMEOUT);
                     if (!resp.success) {
                         return { content: [{ type: 'text', text: JSON.stringify({ error: resp.error }) }], isError: true };
@@ -280,6 +282,24 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
             width_ratio: z.number().optional().describe('장평 (%, 기본 100. 100 미만=좁게, 100 초과=넓게)'),
             font_name_hanja: z.string().optional().describe('한자 글꼴 이름'),
             font_name_japanese: z.string().optional().describe('일본어 글꼴 이름'),
+            font_name_latin: z.string().optional().describe('라틴(영문) 전용 글꼴'),
+            underline_type: z.number().int().min(0).max(7).optional().describe('밑줄 종류 (0=없음,1=실선,2=이중,3=점선,4=파선,5=1점쇄선,6=물결,7=굵은실선)'),
+            underline_color: z.array(z.number().int().min(0).max(255)).length(3).optional().describe('밑줄 색상 [R,G,B]'),
+            strikeout_type: z.number().int().min(0).max(3).optional().describe('취소선 종류 (0=없음,1=단일,2=이중,3=굵은)'),
+            strikeout_color: z.array(z.number().int().min(0).max(255)).length(3).optional().describe('취소선 색상 [R,G,B]'),
+            superscript: z.boolean().optional().describe('위 첨자'),
+            subscript: z.boolean().optional().describe('아래 첨자'),
+            outline: z.boolean().optional().describe('외곽선'),
+            shadow: z.boolean().optional().describe('그림자'),
+            shadow_color: z.array(z.number().int().min(0).max(255)).length(3).optional().describe('그림자 색상 [R,G,B]'),
+            shadow_offset_x: z.number().optional().describe('그림자 X 오프셋'),
+            shadow_offset_y: z.number().optional().describe('그림자 Y 오프셋'),
+            emboss: z.boolean().optional().describe('양각'),
+            engrave: z.boolean().optional().describe('음각'),
+            small_caps: z.boolean().optional().describe('작은 대문자'),
+            underline_shape: z.number().int().optional().describe('밑줄 모양'),
+            strikeout_shape: z.number().int().optional().describe('취소선 모양'),
+            use_kerning: z.boolean().optional().describe('커닝 (자동 자간 조정)'),
         }).optional().describe('텍스트 서식 옵션'),
     }, async ({ text, color, style }) => {
         if (!bridge.getCurrentDocument()) {
@@ -317,7 +337,18 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
             indent: z.number().optional().describe('첫 줄 들여쓰기 (pt, 양수=들여쓰기, 음수=내어쓰기)'),
             left_margin: z.number().optional().describe('왼쪽 여백/나머지 줄 시작위치 (pt)'),
             right_margin: z.number().optional().describe('오른쪽 여백 (pt)'),
-        }, async ({ align, line_spacing, line_spacing_type, space_before, space_after, indent, left_margin, right_margin }) => {
+            page_break_before: z.boolean().optional().describe('문단 앞 페이지 나누기'),
+            keep_with_next: z.boolean().optional().describe('다음 문단과 함께 (제목+본문 분리 방지)'),
+            widow_orphan: z.boolean().optional().describe('과부/고아 방지'),
+            line_wrap: z.number().int().optional().describe('줄 바꿈 방식'),
+            snap_to_grid: z.boolean().optional().describe('그리드에 맞춤'),
+            auto_space_eAsian_eng: z.boolean().optional().describe('한영 자동 간격'),
+            auto_space_eAsian_num: z.boolean().optional().describe('한숫자 자동 간격'),
+            break_latin_word: z.number().int().optional().describe('영문 줄바꿈 (0=단어, 1=글자)'),
+            heading_type: z.number().int().optional().describe('제목 수준 (개요)'),
+            keep_lines_together: z.boolean().optional().describe('줄 함께 유지 (문단 분리 방지)'),
+            condense: z.number().int().optional().describe('문단 압축'),
+        }, async ({ align, line_spacing, line_spacing_type, space_before, space_after, indent, left_margin, right_margin, page_break_before, keep_with_next, widow_orphan, line_wrap, snap_to_grid, auto_space_eAsian_eng, auto_space_eAsian_num, break_latin_word, heading_type, keep_lines_together, condense }) => {
             if (!bridge.getCurrentDocument()) {
                 return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
             }
@@ -340,6 +371,28 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
                     style.left_margin = left_margin;
                 if (right_margin !== undefined)
                     style.right_margin = right_margin;
+                if (page_break_before !== undefined)
+                    style.page_break_before = page_break_before;
+                if (keep_with_next !== undefined)
+                    style.keep_with_next = keep_with_next;
+                if (widow_orphan !== undefined)
+                    style.widow_orphan = widow_orphan;
+                if (line_wrap !== undefined)
+                    style.line_wrap = line_wrap;
+                if (snap_to_grid !== undefined)
+                    style.snap_to_grid = snap_to_grid;
+                if (auto_space_eAsian_eng !== undefined)
+                    style.auto_space_eAsian_eng = auto_space_eAsian_eng;
+                if (auto_space_eAsian_num !== undefined)
+                    style.auto_space_eAsian_num = auto_space_eAsian_num;
+                if (break_latin_word !== undefined)
+                    style.break_latin_word = break_latin_word;
+                if (heading_type !== undefined)
+                    style.heading_type = heading_type;
+                if (keep_lines_together !== undefined)
+                    style.keep_lines_together = keep_lines_together;
+                if (condense !== undefined)
+                    style.condense = condense;
                 const response = await bridge.send('set_paragraph_style', { style });
                 if (!response.success) {
                     return { content: [{ type: 'text', text: JSON.stringify({ error: response.error }) }], isError: true };
@@ -519,12 +572,27 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
                 return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
             }
         });
-        server.tool('hwp_table_merge_cells', '표에서 선택된 셀들을 병합합니다. 먼저 표에 진입한 상태여야 합니다.', { table_index: z.number().int().min(0).describe('표 인덱스') }, async ({ table_index }) => {
+        server.tool('hwp_table_merge_cells', '표의 셀을 병합합니다. start_row/col ~ end_row/col로 범위를 지정하면 해당 영역이 병합됩니다. 범위 미지정 시 현재 선택된 셀이 병합됩니다. 병합 순서는 하단→상단이 안전합니다.', {
+            table_index: z.number().int().min(0).describe('표 인덱스'),
+            start_row: z.number().int().min(0).optional().describe('시작 행 (0부터)'),
+            start_col: z.number().int().min(0).optional().describe('시작 열 (0부터)'),
+            end_row: z.number().int().min(0).optional().describe('끝 행 (0부터)'),
+            end_col: z.number().int().min(0).optional().describe('끝 열 (0부터)'),
+        }, async ({ table_index, start_row, start_col, end_row, end_col }) => {
             if (!bridge.getCurrentDocument())
                 return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
             try {
                 await bridge.ensureRunning();
-                const r = await bridge.send('table_merge_cells', { table_index }, FILL_TIMEOUT);
+                const params = { table_index };
+                if (start_row !== undefined)
+                    params.start_row = start_row;
+                if (start_col !== undefined)
+                    params.start_col = start_col;
+                if (end_row !== undefined)
+                    params.end_row = end_row;
+                if (end_col !== undefined)
+                    params.end_col = end_col;
+                const r = await bridge.send('table_merge_cells', params, FILL_TIMEOUT);
                 if (!r.success)
                     return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
                 bridge.setCachedAnalysis(null);
@@ -534,10 +602,13 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
                 return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
             }
         });
-        server.tool('hwp_table_create_from_data', '2D 배열 데이터로 새 표를 생성합니다. 현재 커서 위치에 표가 삽입됩니다. header_style=true로 첫 행을 자동 스타일링(Bold+배경색)합니다.', {
+        server.tool('hwp_table_create_from_data', '2D 배열 데이터로 새 표를 생성합니다. col_widths로 열 너비(mm), row_heights로 행 높이(mm)를 지정할 수 있습니다. 공문서 표 등 정밀한 레이아웃에 사용하세요.', {
             data: z.array(z.array(z.string())).describe('2D 배열 데이터 [["헤더1","헤더2"],["값1","값2"]]'),
-            header_style: z.boolean().optional().describe('첫 행을 헤더로 자동 스타일링 (Bold+연회색 배경, 기본 false)'),
-        }, async ({ data, header_style }) => {
+            header_style: z.boolean().optional().describe('첫 행을 헤더로 자동 스타일링 (Bold+배경색)'),
+            col_widths: z.array(z.number()).optional().describe('열 너비 배열 (mm 단위, 예: [18, 65, 23, 23])'),
+            row_heights: z.array(z.number()).optional().describe('행 높이 배열 (mm 단위, 예: [10, 12, 12])'),
+            alignment: z.enum(['left', 'center', 'right']).optional().describe('표 정렬 (기본: left)'),
+        }, async ({ data, header_style, col_widths, row_heights, alignment }) => {
             if (!bridge.getCurrentDocument())
                 return { content: [{ type: 'text', text: JSON.stringify({ error: '열린 문서가 없습니다.' }) }], isError: true };
             try {
@@ -545,6 +616,12 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
                 const params = { data };
                 if (header_style)
                     params.header_style = header_style;
+                if (col_widths)
+                    params.col_widths = col_widths;
+                if (row_heights)
+                    params.row_heights = row_heights;
+                if (alignment)
+                    params.alignment = alignment;
                 const r = await bridge.send('table_create_from_data', params, FILL_TIMEOUT);
                 if (!r.success)
                     return { content: [{ type: 'text', text: JSON.stringify({ error: r.error }) }], isError: true };
@@ -974,6 +1051,8 @@ export function registerEditingTools(server, bridge, toolset = 'standard') {
             style: z.object({
                 line_type: z.number().int().min(0).max(5).optional().describe('선 종류: 0=없음, 1=실선, 2=파선, 3=점선, 4=1점쇄선, 5=2점쇄선'),
                 line_width: z.number().optional().describe('선 두께 (pt 단위)'),
+                color: z.string().optional().describe('테두리 색상 (#RRGGBB, 예: "#003366")'),
+                edges: z.array(z.enum(['left', 'right', 'top', 'bottom'])).optional().describe('적용할 방향 (생략 시 전체)'),
             }).optional().describe('테두리 스타일'),
         }, async ({ table_index, cells, style }) => {
             if (!bridge.getCurrentDocument())

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-code-hwp-mcp",
-  "version": "0.3.1",
-  "description": "MCP server for HWP (한글) document automation via pyhwpx COM API. 85+ tools for document editing, analysis, and AI-powered filling.",
+  "version": "0.5.1",
+  "description": "MCP server for HWP (한글) document automation via pyhwpx COM API. 94 tools for document editing, analysis, table formatting, and AI-powered filling.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {