Word Editing MCP Server

Word 編集 MCP サーバー

このサーバーは、Microsoft Word（.docx）ファイルを操作し、正確な書式を維持したまま PDF に変換するためのツールを提供します。

これは、Word ファイルを操作するツールを提供する TypeScript ベースの MCP サーバーです。以下を提供することで、MCP の基本概念を示します。

• Word ファイルの読み取り、変更、削除を行うツール
• Word ファイルを PDF に変換するツール（書式を完全に維持）
• ファイルとフォルダーの操作はすべて、絶対パスまたは相対パス（プロセスの現在の作業ディレクトリを基準とする）を直接指定して実行できます。あらかじめ作業フォルダーを選択する概念はなくなりました。

機能

Word ツール

list_files_in_folder

• 目的：指定したフォルダー内のファイルを一覧表示します。
• パラメーター：folderPath（省略可能。フォルダーへの絶対パスまたは相対パス。省略した場合は現在の作業ディレクトリを使用します）。

read_word_content

• 目的：Word（.docx）ファイルのテキスト内容を読み取ります。
• パラメーター：filePath（.docx ファイルへの絶対パスまたは相対パス）。

replace_word_words

• 目的：Word（.docx）ファイル内の単語を置換し、新しいファイルとして保存します。
• パラメーター：
  • filePath（入力ファイルの絶対パスまたは相対パス）
  • outputFilePath（出力ファイルの絶対パスまたは相対パス）
  • replacements（{from, to} の配列）

delete_word_file

• 目的：Word（.docx）ファイルを削除します。
• パラメーター：filePath（.docx ファイルへの絶対パスまたは相対パス）。

word_to_pdf

• 目的：Word（.docx）ファイルを PDF に変換し、すべての書式と画像を維持します。LibreOffice のインストールが必要です。
• パラメーター：
  • filePath（入力 .docx ファイルの絶対パスまたは相対パス）
  • outputFilePath（出力 .pdf ファイルの絶対パスまたは相対パス）
• 注記：プロフェッショナル品質の変換を行うため、LibreOffice をヘッドレスモードで使用します。LibreOffice がインストールされていない場合は、以下のインストールセクションを参照してください。

完全インストール

Node.js の依存関係をインストールします：

npm install

LibreOffice をインストールします（Word から PDF への変換用）：

npm run install-libreoffice

サーバーをビルドします：

npm run build

自動再ビルドを有効にした開発環境の場合：

npm run watch

Claude Desktop での使用

以下の設定を次のファイルに追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Word Editing Server": {
      "command": "node",
      "args": [
        "/PATH_TO_THE_PROJECT/build/index.js"
      ],
      "env": {
      }
    }
  }
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします。

npm run inspector

Inspector によって、ブラウザーでデバッグツールにアクセスするための URL が表示されます。