🚰 KitchenSink4Word

Microsoft Word를 위한 모든 것, 아니 그 이상. 현재 사용 가능한 가장 완전한 Word(.docx) MCP 서버 — 119가지 도구, 손상되지 않도록 설계되었으며 길고 서식이 많이 적용된 실제 문서로 스트레스 테스트를 거쳤습니다.

탄생 배경: 한 AI 에이전트가 Word 문서에서 표 20개를 편집하는 데 15분이 필요했던 적이 있습니다. 기존 Word MCP 중에는 표 열 삭제, 일괄 편집, 각주 관리, 그리고 목차 삽입을 모드 할 수 있는 것이 없었기 때문입니다. 그래서 평범한 서버 세 개를 설치하는 대신, 이 서버가 하루 만에 만들어졌습니다. 이제 여러분의 에이전트는 그런 문제를 겪지 않을 것입니다.

왜 이 서버인가 (정직한 비교)

이 서버를 만들기 전에 공개된 모드 Word MCP 서버를 조사했습니다 (2026년 8월):

119가지 도구는 다음 영역에 걸쳐 있습니다: 텍스트 및 서식, 표(병합 인식 열 삽입/삭제 및 한 번의 호출로 일괄 편집), 각주/미주(전체 CRUD + 각주↔미주 변환), 목차 및 캡션 목록, 머리글/바닥글/구역, 이미지, 글머리 기호/번호 목록, 스레드형 주석, 변경 내용 추적(읽기, 작성자별 수락/거부, 그리고 변경 내용 추적으로 편집 쓰기), 추가로 Word-COM 기반 문서 비고, 필드 새로 고침, PDF 내보내기, Windows에서 열 때 깨끗한지 검증.

Related MCP server: word-mcp-live

v1.2의 새로운 기능 (2026-08-28)

• Word 네이트브 인용 및 참고문헌: 구조화된 출처 저장소, 페이지/억제 스위치가 있는 CITATION 필드, BIBLIOGRAPHY 필드, 선택 가능한 12가지 스타일 (APA, Chicago, MLA, IEEE, ...) — 종단 간 검증 완료: Word가 선택한 스타일로 필드를 렌더링합니다.

• 색인 (중첩 및 참조(see-reference)가 있는 XE 항목 + INDEX 필드) 및 캡션 목록 (표 목록/그림 목록).

• 장문 문서 레이아웃 키트: 로마 숫자 페이지 형식, 줄 번호, 워터마크(Word의 워터마크 제거와 호환), 다단 구역, 페이지 X / Y.

• 문서 보호: Word와 호환되는 SHA-512 암호 해시 (Word 자체 출력과 바이트 단위로 검증됨); trackedChanges 모드는 받는 사람의 편집이 추적되도록 강제합니다.

• 구조 작업: move_section (제목과 해당 구역 전체, 표 포함), 템플릿 전송(이름 기반 스타일 재매핑으로 참조 문서와 일치하도록 스타일 변경), 사욛자 지졍 스타일, 문자 스타일, 문서 속성, 이미지 대체 텍스트.

• 표 보강: gridBefore/gridAfter 행, 이르이 있는 표 스타일, 정렬, 분할, 머리글 행 반복, 중첩 표 읽기/쓰기, 텍스트 방향.

• 롱테일 서식: 작은 대문자, 숨은 텍스트, 문자 간격, 커닝, CJK 언어 태그 지졍, 지시선이 있는 탭 정지점, 문단 테두리/음영, 위도우 컨트롤(외톨이 줄 방지), 대/소문자 변겅.

• 분석: 구역별 단어 수, APA 인용 일치성 검사, Word의 맞춤법 검사 오류 및 가독성 통계, 장 병합, 검토자 결합, 암호로 암호화된 저장.

무엇이 다른가

• 병합 인식 표 열 작업. delete_columns / insert_columns는 가로 및 세로로 병합된 셀에서도 올바르게 작동합니다 (gridSpan 축소, vMerge 체인 재루트). 현재 글을 쓰는 시점에 이 기능을 가진 공개 Word MCP는 없습니다.

• 일괄 우선 API. 20개를 편집하는 것은 페이로드 하나로 set_cells를 한 번 호출하는 일이지, 20번의 왕복이 아닙니다.

• 변경 내용 추적 쓰기. replace/insert/delete/cell 도구에 track=True, author="Jane"을 지졍하면 받는 사람이 수락/거부할 수 있는 실제 Word 수정 내용이 생성됩니다 — 서버 자체 개정 엔진을 상대로 왕복 검증을 거쳤습니다.

• 문서 비교. com_compare_documents는 문서의 두 버전 사이에 Word 네이티브 교정(redline)을 생합니다.

• 절대 손상되지 않음. 원자적 저장(임시 파일 → 구조 검증 → 교체), 모든 변경 전 자동 타임스탬프 백업, 편집되지 않는 모든 것의 바이트 단위 동일 통과 (수식, 텍스트 상자, 콘텐츠 컨트롤은 그대로 유지됨), 그리고 타입이 명확한 오류 — Word에서 열려 있는 파일은 멈추지 않고 메시지와 함께 거부됩니다.

• 분할된 run에서도 안전. 찾기/바꾸기는 Word가 임의로 분할한 run들에 걸쳐 문자별 서식을 보존하면서 작동하며, 사용자 정규식에 대한 ReDoS 시간 초과 가드와 선택적 max_replacements 피해 범위 제한이 있습니다.

요구 사항

• Windows (COM 도구는 Microsoft Word 설치 필요; 그 외 모든 도구는 순수 파일 조작이며 Word 없이도 동작)

• Python 3.12+ (3.14에서 개발됨)

설치

git clone https://github.com/nometalalchemist/KitchenSink4Word
cd KitchenSink4Word
python -m venv .venv
.venv\Scripts\pip install -e .

Claude Code에 등록:

claude mcp add word -s user -- <absolute-path-to>\word-mcp\.venv\Scripts\word-mcp.exe

안전 모델

• 모든 변경 도구는 file_path를 받아 첫 변경 전에 같은 위치에 <name>.bak-<timestamp>.docx를 씁니다 (backup=False로 건너뛸 수 있음).

• 저장은 원자적이며 검증됩니다; 실패한 작업은 원본을 바이트 단위로 동일하게 남깁니다.

• 각주 참조를 포함하는 콘텐츠를 삭제하면 고아가 된 정의도 자동으로 제거됩니다; validate_document / validate_notes가 양방향 무결성을 보고합니다.

• 문단 삭제는 필드 (TOC, PAGEREF)를 반으로 자르거나 구역 나눔을 조용히 삼키는 범위를 거부합니다.

테스트

테스트 344개, 어디서나 실행됩니다. 테스트 스위트는 비공개 실제 문서 모음 (책 분량의 장, 각주 171개가 있는 문서, 변경 내용 추적 126개와 검토자 주석이 있는 원고)을 대상으로 개발되었으며, CI는 구조적으로 동등한 합성 대체 문서 (tests/make_corpus.py)를 자동 생성하므로 전체 스위트를 어떤 머신에서도 실행할 수 있습니다 — 여러분의 머신과 모든 풀 리퀘스트를 포함합니다. 로컬의 실제 문서가 있으면 우선합니다. tests/word_validator.py는 보이지 않는 Word에서 출력물을 열고 복구 프롬프트가 뜨면 실패 처리합니다 — 결정적인 손상 검사입니다.

개발 이력: Claude Code로 하루 만에 (2026-08-27) 구축되었고, 세 차례 라운드로 테스트되었습니다 — 단계별 단위 게이트, 엣지 케이스 세션 (89회 호출), 그리고 원시 MCP stdio 전송을 통한 두 차례의 "insane mode" 라운드 (규모 극한 테스트, 병리적 병합 토폴로지, 유니코드/스키마 퍼징, ReDoS, Word 잠금 수명 주기, COM 누수 검사), 그리고 전용 교차 기능 상호작용 버그 사냥도 있었습니다. 발견된 모든 문제는 회귀 테스트로 수정되었습니다. research/는 구현의 기반이 되는 OOXML 알고리즘과 함정을 문서화하며, 연구된 MIT 라이선스 참조 구현에 대한 출처를 표기합니다.

알려진 제한 사항

• Word에서 열려 있는 문서의 실시간 편집은 불가능합니다 (깔끔하게 거부됨; COM 도구는 저장된 파일에서 작동).

• 목차/캡션 목록의 페이지 번호는 필드 업데이트가 필요합니다: 다음 Word 열기 시 자동 (update_on_open) 또는 com_refresh_fields로 즉시 업데이트할 수 있습니다.

라이선스

PolyForm Noncommercial 1.0.0 — 개인, 학술, 연구 및 기타 모드 비상업적 용도로 무료입니다. 상업적 사용은 사용 전에 별도 라이선스가 필요합니다 — 이슈를 열어 협의하세요.