MCP Server Office

A Model Context Protocol (MCP) server providing tools to read/write Microsoft Word (docx) files.

Usage

Install with pip:

Then, start the MCP server:

Or using uv, just:

Available Tools

1. read_docx : Read complete contents of a docx file including tables and images.
   • Input: path (string) - Absolute path to the target file
   • Note: Images are converted to [Image] placeholders, and track changes are not shown
2. write_docx : Create a new docx file with given content.
   • Input:
     • path (string) - Absolute path to target file
     • content (string) - Content to write to the file
   • Note: Use double line breaks for new paragraphs, and [Table] tag with | separators for tables
3. edit_docx_paragraph : Make text replacements in specified paragraphs of a docx file.
   • Input:
     • path (string) - Absolute path to file to edit
     • edits (array) - List of dictionaries containing search/replace text and paragraph index
       • paragraph_index (number) - 0-based index of the paragraph to edit
       • search (string) - Text to find within the specified paragraph
       • replace (string) - Text to replace with
   • Note: Each search string must match exactly once within the specified paragraph
4. edit_docx_insert : Insert new paragraphs into a docx file.
   • Input:
     • path (string) - Absolute path to file to edit
     • inserts (array) - List of dictionaries containing text and optional paragraph index
       • text (string) - Text to insert as a new paragraph
       • paragraph_index (number, optional) - 0-based index of the paragraph before which to insert. If not specified, insert at the end.

Requirements

• 파이썬 >= 3.12
• Dependencies:
  • mcp[cli] >= 1.2.0
  • python-docx >= 1.1.2

MCP Server Office(한국어)

Microsoft Word(docx) 파일의 읽기/쓰기를 제공하는 Model Context Protocol(MCP) 서버입니다.

사용방법

pip를 사용하여 설치:

MCP 서버 시작:

또는 uv를 사용하는 경우 :

사용 가능한 도구

1. read_docx : docx 파일의 내용을 테이블이나 이미지를 포함하여 완전히 읽습니다.
   • 입력: path (문자열) - 대상 파일의 절대 경로
   • 참고: 이미지는 [Image] 자리 표시자로 변환되며 변경 내역은 표시되지 않습니다.
2. write_docx : 새로운 docx 파일을 지정된 내용으로 작성합니다.
   • 입력:
     • path (문자열) - 만들 파일의 절대 경로
     • content (문자열) - 파일에 쓰는 내용
   • 주의: 단락은 2개의 개행으로 단락지어, 테이블은 [Table] 태그와 |단락을 사용합니다
3. edit_docx_paragraph : docx 파일에서 지정된 단락의 텍스트를 바꿉니다.
   • 입력:
     • path (문자열) - 편집할 파일의 절대 경로
     • edits (배열) - 검색 / 대체 텍스트와 단락 색인이 포함 된 사전 목록
       • paragraph_index (수치) - 편집하는 단락의 0 베이스의 인덱스
       • search (문자열) - 지정된 단락 내에서 검색하는 텍스트
       • replace (문자열) - 대체할 텍스트
   • 참고: 각 검색 문자열은 지정된 단락 내에서 한 번만 일치해야 합니다.
4. edit_docx_insert : docx 파일에 새 단락을 삽입합니다.
   • 입력:
     • path (문자열) - 편집할 파일의 절대 경로
     • inserts (배열) - 텍스트와 옵션의 단락 인덱스를 포함한 사전의 리스트
       • text (문자열) - 새 단락으로 삽입할 텍스트
       • paragraph_index (수치, 옵션) - 삽입하는 위치의 단락의 0 베이스의 인덱스. 지정하지 않으면 끝에 삽입됩니다.

작동 요구사항

• 파이썬 >= 3.12
• 종속 패키지:
  • mcp[cli] >= 1.2.0
  • python-docx >= 1.1.2