MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-14 19:30
태그:
#MCP #커뮤니티 #서버 #워드프로세서 #오피스 #문서 #미디어

링크된 문서

역링크

Office-Word-MCP-Server

Office-Word-MCP-Server

Office-Word-MCP-Server는 Microsoft Word 문서를 생성, 읽기 및 조작하기 위한 MCP 서버입니다. 이 서버를 통해 LLM은 전문적인 문서를 처음부터 생성하거나 기존 문서를 수정하고, 서식을 지정하며, 다양한 콘텐츠 요소를 관리할 수 있습니다. 보고서, 논문, 계약서, 뉴스레터 등 다양한 종류의 문서 작업에 활용할 수 있으며, 템플릿 기반 문서 자동화에도 유용합니다.

특징

  • 문서 관리: 새 문서 생성, 기존 파일 열기, 저장 및 내보내기
  • 콘텐츠 편집: 텍스트 추가, 수정, 삭제, 서식 지정
  • 구조화 요소: 제목, 목차, 머리글/바닥글, 페이지 번호 관리
  • 스타일 적용: 단락 스타일, 문자 스타일, 테마 적용
  • 콘텐츠 요소: 이미지, 표, 차트, 도형, 주석 등 삽입 및 관리
  • 참조 기능: 각주, 미주, 인용, 참고문헌 관리
  • 검토 기능: 변경 내역, 주석, 병합 등 문서 검토 관리
  • 템플릿 관리: 문서 템플릿 적용 및 사용자 정의
  • PDF 내보내기: 문서를 PDF 및 기타 형식으로 내보내기
  • 일괄 처리: 여러 문서의 일괄 생성 및 수정

API

도구

문서 관리 도구

  • create_document: 새 문서 생성
  • 입력: 제목, 템플릿, 옵션

  • 출력: 생성된 문서 ID 및 경로

  • open_document: 기존 문서 열기

  • 입력: 파일 경로

  • 출력: 로드된 문서 ID 및 메타데이터

  • save_document: 문서 저장

  • 입력: 문서 ID, 저장 경로, 형식
  • 출력: 저장 결과 및 파일 정보

콘텐츠 편집 도구

  • add_text: 텍스트 추가
  • 입력: 문서 ID, 텍스트 내용, 위치, 서식

  • 출력: 추가된 텍스트 범위

  • replace_text: 텍스트 대체

  • 입력: 문서 ID, 검색 텍스트, 대체 텍스트, 옵션

  • 출력: 대체 작업 결과 및 대체 수

  • format_text: 텍스트 서식 지정

  • 입력: 문서 ID, 텍스트 범위, 서식 옵션
  • 출력: 서식 적용 결과

구조 및 스타일 도구

  • apply_style: 스타일 적용
  • 입력: 문서 ID, 범위, 스타일 이름

  • 출력: 스타일 적용 결과

  • add_heading: 제목 추가

  • 입력: 문서 ID, 텍스트, 수준, 위치

  • 출력: 추가된 제목 범위

  • create_toc: 목차 생성

  • 입력: 문서 ID, 위치, 옵션

  • 출력: 생성된 목차 범위

  • set_header_footer: 머리글/바닥글 설정

  • 입력: 문서 ID, 내용, 섹션, 유형
  • 출력: 설정 결과

요소 추가 도구

  • add_image: 이미지 추가
  • 입력: 문서 ID, 이미지 경로/URL, 위치, 크기, 캡션

  • 출력: 추가된 이미지 객체 ID

  • add_table: 표 추가

  • 입력: 문서 ID, 행/열 수, 데이터, 위치, 스타일

  • 출력: 추가된 표 객체 ID

  • add_footnote: 각주 추가

  • 입력: 문서 ID, 참조 텍스트, 각주 내용

  • 출력: 추가된 각주 ID

  • add_citation: 인용 추가

  • 입력: 문서 ID, 참조 위치, 인용 데이터
  • 출력: 추가된 인용 ID

검토 도구

  • add_comment: 주석 추가
  • 입력: 문서 ID, 텍스트 범위, 주석 내용, 작성자

  • 출력: 추가된 주석 ID

  • track_changes: 변경 내역 추적 설정

  • 입력: 문서 ID, 활성화 여부
  • 출력: 설정 결과

유틸리티 도구

  • export_to_pdf: PDF로 내보내기
  • 입력: 문서 ID, 출력 경로, 옵션

  • 출력: 내보내기 결과 및 파일 정보

  • get_document_statistics: 문서 통계 조회

  • 입력: 문서 ID, 통계 유형(단어 수, 문자 수, 페이지 수 등)

  • 출력: 요청된 통계 정보

  • find_text: 텍스트 검색

  • 입력: 문서 ID, 검색 텍스트, 검색 옵션
  • 출력: 검색 결과 위치 목록

사용 방법

설치

# npm을 통한 설치
npm install -g office-word-mcp-server

# 또는 GitHub 저장소에서 직접 설치
git clone https://github.com/author/office-word-mcp-server
cd office-word-mcp-server
npm install

필요 조건

  • Windows 환경: Microsoft Word가 설치되어 있어야 합니다.
  • macOS/Linux 환경: Word Online API 연결을 위한 Microsoft 계정 또는 호환 라이브러리
  • Node.js 14 이상이 설치되어 있어야 합니다.

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정할 수 있습니다:

{
  "mcpServers": {
    "word": {
      "command": "npx",
      "args": ["-y", "office-word-mcp-server"],
      "env": {
        "MICROSOFT_OFFICE_PATH": "/path/to/office",
        "OUTPUT_DIRECTORY": "/path/to/output"
      }
    }
  }
}

사용 예시

// 새 문서 생성
const document = await create_document({
  title: "연간 사업 계획서",
  template: "business_report"
});

// 제목 추가
await add_heading({
  documentId: document.id,
  text: "2025년 연간 사업 계획서",
  level: 1,
  position: "start"
});

// 개요 섹션 추가
await add_heading({
  documentId: document.id,
  text: "1. 개요",
  level: 2,
  position: "end"
});

await add_text({
  documentId: document.id,
  text: "본 문서는 2025년 회계연도의 주요 사업 계획과 예산 배분을 개괄합니다. 올해의 주요 목표는 신규 시장 개척, 제품 라인 확장, 그리고 고객 서비스 품질 향상입니다.",
  position: "end",
  format: {
    fontFamily: "Arial",
    fontSize: 11
  }
});

// 표 추가
await add_table({
  documentId: document.id,
  rows: 4,
  columns: 3,
  data: [
    ["부서", "예산(백만원)", "주요 목표"],
    ["영업", "500", "매출 20% 증가"],
    ["마케팅", "300", "브랜드 인지도 향상"],
    ["연구개발", "450", "신제품 3종 출시"]
  ],
  position: "end",
  style: "Grid Table 5 Dark"
});

// 이미지 추가
await add_image({
  documentId: document.id,
  path: "/path/to/budget_chart.png",
  position: "end",
  size: { width: 400, height: 300 },
  caption: "그림 1: 2025년 부서별 예산 배분"
});

// 목차 생성
await create_toc({
  documentId: document.id,
  position: "start",
  options: {
    levels: 3,
    includePageNumbers: true
  }
});

// 문서 저장
await save_document({
  documentId: document.id,
  path: "/path/to/annual_business_plan.docx"
});

// PDF로 내보내기
await export_to_pdf({
  documentId: document.id,
  path: "/path/to/annual_business_plan.pdf"
});

연결된 구성 요소

  • Office-PowerPoint-MCP-Server - Word 문서와 PowerPoint 프레젠테이션 간의 콘텐츠 공유 및 통합
  • Excel - Excel 데이터를 Word 문서에 통합
  • Markdown2doc - Markdown에서 Word 문서 생성 또는 Word 문서를 Markdown으로 변환
  • Markdownify - Word 문서를 Markdown으로 변환