MCP DOCX Template Server

스타일이 적용된 Microsoft Word 템플릿을 복제하고 다른 문서의 콘텐츠로 채워 이미지, 레이아웃, 글꼴, 색상 및 단락 스타일을 보존하는 휴대용 MCP 서버입니다.

도구

서버는 세 가지 도구를 제공합니다:

• analyze_template — .docx 템플릿을 검사하고 단락 구조, 이미지, 스타일 및 콘텐츠 스키마를 반환합니다. 또한 템플릿 옆에 <template>.docx.md 설명자를 작성하여 반복 조회(예: map_content_to_template 프롬프트)가 다시 분석할 필요가 없도록 합니다.

• extract_content — 콘텐츠 .docx에서 편집 가능한 텍스트 블록을 추출합니다.

• fill_template — 템플릿을 복제하고 레이블-텍스트 매핑을 사용하여 편집 가능한 텍스트를 교체합니다. 선택적으로 결과를 PDF로 변환합니다.

Related MCP server: Word MCP Server

프롬프트

• map_content_to_template — template_path와 content_path가 주어지면 템플릿의 .docx.md 설명자(아직 없으면 먼저 분석하고 작성)와 추출된 콘텐츠를 읽고 content_mapping을 구축하기 위한 지침 메시지를 반환합니다. 매핑이 모호할 때는 어시스턴트가 사용자에게 직접 물어본 다음 fill_template을 호출하도록 지시합니다.

설치

pip install .

또는 테스트를 포함한 개발의 경우:

pip install -e ".[dev]"

Claude Desktop 사용법

서버를 Claude Desktop 구성(claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "docx-template": {
      "command": "mcp-docx-template-server"
    }
  }
}

서버는 stdio 전송을 사용합니다. 구성이 완료되면 Claude는 analyze_template, extract_content, fill_template을 호출할 수 있습니다.

예제 흐름

1. 템플릿 분석:

{
  "template_path": "/path/to/SSIT_Template.docx"
}

2. 원본 문서에서 콘텐츠 추출:

{
  "content_path": "/path/to/NetApp_Content.docx"
}

3. 템플릿 채우기:

{
  "template_path": "/path/to/SSIT_Template.docx",
  "content_mapping": {
    "overview": "NetApp Cutover Dependency Mapper",
    "business_challenge": "Business Challenge",
    "body_1": "Long body paragraph...",
    "solution_item_1": "Title\nBody text..."
  },
  "output_path": "/path/to/output.docx",
  "convert_to_pdf": true
}

개발

테스트 실행:

pytest

라이선스

MIT