Skip to main content
Glama
Sign In
enesjakozh

Office Word MCP Server

by GongRzhe
Verified
GitHub
Python
MIT License
1
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Office-Word-MCP-서버

Microsoft Word 문서를 생성, 읽기 및 조작하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 비서가 표준화된 인터페이스를 통해 Word 문서를 작업할 수 있도록 지원하며, 풍부한 문서 편집 기능을 제공합니다.

개요

Office-Word-MCP-Server는 모델 컨텍스트 프로토콜을 구현하여 Word 문서 작업을 도구 및 리소스 형태로 제공합니다. AI 비서와 Microsoft Word 문서를 연결하는 다리 역할을 하여 문서 생성, 콘텐츠 추가, 서식 지정 및 분석을 지원합니다.

예

폼프트

산출

특징

문서 관리

  • 메타데이터를 사용하여 새 Word 문서 만들기
  • 텍스트 추출 및 문서 구조 분석
  • 문서 속성 및 통계 보기
  • 디렉토리에서 사용 가능한 문서 나열
  • 기존 문서의 사본을 만듭니다

콘텐츠 생성

  • 다양한 레벨의 제목 추가
  • 선택적 스타일로 문단 삽입
  • 사용자 정의 데이터로 테이블 만들기
  • 비례적 크기 조정으로 이미지 추가
  • 페이지 나누기 삽입

서식 있는 텍스트 서식

  • 특정 텍스트 섹션 서식 지정(굵게, 기울임꼴, 밑줄)
  • 텍스트 색상 및 글꼴 속성 변경
  • 텍스트 요소에 사용자 정의 스타일 적용
  • 문서 전체에서 텍스트 검색 및 바꾸기

표 서식

  • 테두리와 스타일을 사용하여 표 서식 지정
  • 고유한 서식을 사용하여 헤더 행 만들기
  • 셀 음영 및 사용자 정의 테두리 적용
  • 가독성 향상을 위한 구조 표

고급 문서 조작

  • 문단 삭제
  • 사용자 정의 문서 스타일 만들기
  • 문서 전체에 일관된 서식 적용
  • 세부적인 제어를 통해 특정 텍스트 범위 서식 지정

설치

필수 조건

  • Python 3.8 이상
  • pip 패키지 관리자

기본 설치

지엑스피1

설치 스크립트 사용

또는 다음을 처리하는 제공된 설정 스크립트를 사용할 수 있습니다.

  • 필수 조건 확인
  • 가상 환경 설정
  • 종속성 설치
  • MCP 구성 생성
python setup_mcp.py

데스크톱용 Claude 사용

구성

방법 1: 로컬 설치 후

  1. 설치 후 Claude for Desktop 구성 파일에 서버를 추가합니다.
{ "mcpServers": { "word-document-server": { "command": "python", "args": [ "/path/to/word_server.py" ] } } }

방법 2: 설치 없이(uvx 사용)

  1. uvx 패키지 관리자를 사용하여 로컬 설치 없이도 Claude for Desktop이 서버를 사용하도록 구성할 수도 있습니다.
{ "mcpServers": { "word-document-server": { "command": "uvx", "args": [ "--from", "office-word-mcp-server", "word_mcp_server" ] } } }
  1. 구성 파일 위치:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. 구성을 로드하려면 데스크톱용 Claude를 다시 시작하세요.

예제 작업

구성이 완료되면 Claude에게 다음과 같은 작업을 수행하도록 요청할 수 있습니다.

  • "제목 페이지가 있는 'report.docx'라는 새 문서를 만듭니다."
  • "문서에 제목과 세 개의 단락을 추가합니다"
  • "판매 데이터가 포함된 4x4 테이블 삽입"
  • "2번째 문단의 '중요'라는 단어를 굵고 빨간색으로 표시하세요."
  • "'이전 용어'의 모든 인스턴스를 검색하여 '새 용어'로 바꾸세요"
  • "섹션 제목에 대한 사용자 정의 스타일 만들기"
  • "내 문서의 표에 서식 적용"

API 참조

문서 생성 및 속성

create_document(filename, title=None, author=None) get_document_info(filename) get_document_text(filename) get_document_outline(filename) list_available_documents(directory=".") copy_document(source_filename, destination_filename=None)

콘텐츠 추가

add_heading(filename, text, level=1) add_paragraph(filename, text, style=None) add_table(filename, rows, cols, data=None) add_picture(filename, image_path, width=None) add_page_break(filename)

텍스트 서식

format_text(filename, paragraph_index, start_pos, end_pos, bold=None, italic=None, underline=None, color=None, font_size=None, font_name=None) search_and_replace(filename, find_text, replace_text) delete_paragraph(filename, paragraph_index) create_custom_style(filename, style_name, bold=None, italic=None, font_size=None, font_name=None, color=None, base_style=None)

표 서식

format_table(filename, table_index, has_header_row=None, border_style=None, shading=None)

문제 해결

일반적인 문제

  1. 누락된 스타일
    • 일부 문서에는 제목 및 표 작업에 필요한 스타일이 없을 수 있습니다.
    • 서버는 누락된 스타일을 만들거나 직접 서식을 사용하려고 시도합니다.
    • 최상의 결과를 얻으려면 표준 Word 스타일이 있는 템플릿을 사용하세요.
  2. 권한 문제
    • 서버에 문서 경로에 대한 읽기/쓰기 권한이 있는지 확인하세요.
    • copy_document 함수를 사용하여 잠긴 문서의 편집 가능한 사본을 만듭니다.
    • 작업이 실패하면 파일 소유권과 권한을 확인하세요.
  3. 이미지 삽입 문제
    • 이미지 파일에는 절대 경로를 사용하세요
    • 이미지 형식 호환성 확인(JPEG, PNG 권장)
    • 이미지 파일 크기 및 권한 확인

디버깅

환경 변수를 설정하여 자세한 로깅을 활성화합니다.

export MCP_DEBUG=1 # Linux/macOS set MCP_DEBUG=1 # Windows

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

  1. 저장소를 포크하세요
  2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
  3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
  4. 브랜치에 푸시( git push origin feature/amazing-feature )
  5. 풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

참고: 이 서버는 시스템의 문서 파일과 상호 작용합니다. Claude for Desktop 또는 다른 MCP 클라이언트에서 작업을 확인하기 전에 요청된 작업이 적절한지 항상 확인하십시오.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

View all tools

표준화된 도구와 리소스를 통해 AI 도우미가 Microsoft Word 문서를 만들고, 읽고, 편집하고, 서식을 지정할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

  1. Overview
    1. Example
  2. Features
    1. Document Management
    2. Content Creation
    3. Rich Text Formatting
    4. Table Formatting
    5. Advanced Document Manipulation
  3. Installation
    1. Prerequisites
    2. Basic Installation
    3. Using the Setup Script
  4. Usage with Claude for Desktop
    1. Configuration
    2. Example Operations
  5. API Reference
    1. Document Creation and Properties
    2. Content Addition
    3. Text Formatting
    4. Table Formatting
  6. Troubleshooting
    1. Common Issues
    2. Debugging
  7. Contributing
    1. License
      1. Acknowledgments

        Related Resources

        ID: llldhr59w2