MCP Server Office

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

Installing via Smithery

To install Server Office for Claude Desktop automatically via Smithery :

npx -y @smithery/cli install @famano/mcp-server-office --client claude

Usage

Install with pip:

pip install mcp-server-office

Then, start the MCP server:

mcp-server-office

Or using uv, just:

uvx mcp-server-office

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.

Related MCP server: DOCX MCP Server

Requirements

• 파이썬 >= 3.12

• Dependencies:

  • mcp[cli] >= 1.2.0

  • python-docx >= 1.1.2

MCP Server Office(한국어)

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

Smithery로 설치

Smithery를 통해 Claude Desktop에 Server Office를 자동으로 설치하려면:

npx -y @smithery/cli install @famano/mcp-server-office --client claude

사용방법

pip를 사용하여 설치:

pip install mcp-server-office

MCP 서버 시작:

mcp-server-office

또는 uv를 사용하는 경우 :

uvx mcp-server-office

사용 가능한 도구

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