# 文档编辑服务
## 基本信息
- Slug: `famano-mcp-server-office`
- Source: modelscope
- Publisher: @famano/mcp-server-office
- Categories: file-systems / developer-tools
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@famano/mcp-server-office
## 简介
一个通过模型上下文协议（Model Context Protocol）提供读取、写入和编辑微软Word（docx）文件工具的服务器，允许进行整篇文档读取、内容创建、目标段落编辑以及文本插入等操作。
## 安装提示

```bash
pip install mcp-server-office
```

## MCP Server 详情

# MCP Server Office

提供 Microsoft Word (docx) 文件读写工具的模型上下文协议 (MCP) 服务器。

## 使用方法

使用 pip 安装：

```bash
pip install mcp-server-office
```


然后，启动 MCP 服务器：

```bash
mcp-server-office
```


或者使用 uv，只需：

```bash
uvx mcp-server-office
```


### 可用工具

1. `read_docx`: 读取 docx 文件的完整内容，包括表格和图片。

   - 输入: `path` (字符串) - 目标文件的绝对路径
   - 注意: 图片将被转换为 [Image] 占位符，并且不会显示修订记录
2. `write_docx`: 使用给定的内容创建一个新的 docx 文件。

   - 输入:
     - `path` (字符串) - 目标文件的绝对路径
     - `content` (字符串) - 要写入文件的内容
   - 注意: 使用双换行表示新段落，并使用带有 | 分隔符的 [Table] 标签来表示表格
3. `edit_docx_paragraph`: 在指定的 docx 文件段落中进行文本替换。

   - 输入:
     - `path` (字符串) - 要编辑的文件的绝对路径
     - `edits` (数组) - 包含搜索/替换文本和段落索引的字典列表
       - `paragraph_index` (数字) - 要编辑的段落的基于0的索引
       - `search` (字符串) - 在指定段落内查找的文本
       - `replace` (字符串) - 替换文本
   - 注意: 每个搜索字符串在指定段落内必须精确匹配一次
4. `edit_docx_insert`: 向 docx 文件中插入新的段落。

   - 输入:
     - `path` (字符串) - 要编辑的文件的绝对路径
     - `inserts` (数组) - 包含文本和可选段落索引的字典列表
       - `text` (字符串) - 作为新段落插入的文本
       - `paragraph_index` (数字, 可选) - 在其之前插入的新段落的基于0的索引。如果未指定，则在末尾插入。

## 需求

- Python >= 3.12
- 依赖项:
  - mcp[cli] >= 1.2.0
  - python-docx >= 1.1.2

---

# MCP Server Office (日本語)

Microsoft Word (docx) ファイルの読み書きを提供するModel Context Protocol (MCP) サーバーです。

## 使用方法

pipを使用してインストール:

```bash
pip install mcp-server-office
```


MCPサーバーの起動:

```bash
mcp-server-office
```


または、uvを使う場合:

```bash
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ベースのインデックス。指定しない場合は末尾に挿入されます。

## 動作要件

- Python >= 3.12
- 依赖包:
  - mcp[cli] >= 1.2.0
  - python-docx >= 1.1.2