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
-
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
- Input:
-
write_docx: Create a new docx file with given content.- Input:
path(string) - Absolute path to target filecontent(string) - Content to write to the file
- Note: Use double line breaks for new paragraphs, and [Table] tag with | separators for tables
- Input:
-
edit_docx_paragraph: Make text replacements in specified paragraphs of a docx file.- Input:
path(string) - Absolute path to file to editedits(array) - List of dictionaries containing search/replace text and paragraph indexparagraph_index(number) - 0-based index of the paragraph to editsearch(string) - Text to find within the specified paragraphreplace(string) - Text to replace with
- Note: Each search string must match exactly once within the specified paragraph
- Input:
-
edit_docx_insert: Insert new paragraphs into a docx file.- Input:
path(string) - Absolute path to file to editinserts(array) - List of dictionaries containing text and optional paragraph indextext(string) - Text to insert as a new paragraphparagraph_index(number, optional) - 0-based index of the paragraph before which to insert. If not specified, insert at the end.
- Input:
Requirements
- Python >= 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
利用可能なツール
-
read_docx: docxファイルの内容を表やイメージを含めて完全に読み取ります。- 入力:
path(文字列) - 対象ファイルの絶対パス - 注意: 画像は[Image]というプレースホルダーに変換され、変更履歴は表示されません
- 入力:
-
write_docx: 新しいdocxファイルを指定された内容で作成します。- 入力:
path(文字列) - 作成するファイルの絶対パスcontent(文字列) - ファイルに書き込む内容
- 注意: 段落は2つの改行で区切り、表は[Table]タグと|区切りを使用します
- 入力:
-
edit_docx_paragraph: docxファイル内の指定された段落のテキストを置換します。- 入力:
path(文字列) - 編集するファイルの絶対パスedits(配列) - 検索/置換テキストと段落インデックスを含む辞書のリストparagraph_index(数値) - 編集する段落の0ベースのインデックスsearch(文字列) - 指定された段落内で検索するテキストreplace(文字列) - 置換するテキスト
- 注意: 各検索文字列は指定された段落内で一度だけマッチする必要があります
- 入力:
-
edit_docx_insert: docxファイルに新しい段落を挿入します。- 入力:
path(文字列) - 編集するファイルの絶対パスinserts(配列) - テキストとオプションの段落インデックスを含む辞書のリストtext(文字列) - 新しい段落として挿入するテキストparagraph_index(数値, オプション) - 挿入する位置の段落の0ベースのインデックス。指定しない場合は末尾に挿入されます。
- 入力:
動作要件
- Python >= 3.12
- 依存パッケージ:
- mcp[cli] >= 1.2.0
- python-docx >= 1.1.2