Doc Tools Mcp

Word Tools MCP Server

AI を活用した Word ドキュメント操作機能を提供する Model Context Protocol（MCP）サーバーです。このサーバーは MCP プロトコルを実装し、自然言語でのやり取りを通じて、AI アプリケーションが Word ドキュメントを作成、編集、管理できるようにします。

機能

• MCP プロトコルの完全な実装
• Word ドキュメントの作成と管理
• リッチテキストコンテンツの操作
• テーブルの作成と書式設定
• ドキュメントレイアウトの制御
• ドキュメントメタデータの管理
• ドキュメントの状態をリアルタイムで監視

前提条件

• Node.js 14 以降
• Microsoft Word（高度な機能を利用する場合は任意）

インストール

npx @puchunjie/doc-tools-mcp

または、グローバルにインストールします。

npm install -g @puchunjie/doc-tools-mcp

プロジェクトの依存関係として使用する場合：

npm install @puchunjie/doc-tools-mcp

使用方法

1. MCP サーバーを起動します。

npx @puchunjie/doc-tools-mcp

2. サーバーはデフォルトでポート 8765 で起動します。

3. AI アプリケーション（例：Cursor、VSCode）が MCP サーバーを使用するように設定します。

   http://localhost:8765
   

MCP ツール

サーバーは次の MCP 関数を提供します。

• create_document - 新しい Word ドキュメントを作成します

  • パラメーター：filePath（必須）、title、author

• open_document - 既存の Word ドキュメントを開きます

  • パラメーター：filePath（必須）

• add_paragraph - ドキュメントに段落を追加します

  • パラメーター：filePath（必須）、text（必須）、style、alignment

• add_table - ドキュメントにテーブルを追加します

  • パラメーター：filePath（必須）、rows（必須）、cols（必須）、headers、data

• search_and_replace - ドキュメント内のテキストを検索して置換します

  • パラメーター：filePath（必須）、searchText（必須）、replaceText（必須）、matchCase

• set_page_margins - ドキュメントのページ余白を設定します

  • パラメーター：filePath（必須）、top、right、bottom、left

• get_document_info - ドキュメントのメタデータを取得します

  • パラメーター：filePath（必須）

AI アプリケーションとの統合

Cursor

1. Cursor の設定ファイル ~/.cursor/mcp.json を開きます
2. 次の設定を追加します。

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "npx",
      "args": [
        "@puchunjie/doc-tools-mcp"
      ]
    }
  }
}

または、ローカル開発版の場合：

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "node",
      "args": [
        "/path/to/your/doc-tools-mcp/dist/mcp-server.js"
      ]
    }
  }
}

設定後は、自然言語を使って Word ドキュメントを操作できます。

"Create a new document named report.docx"
"Add a heading 'Monthly Report' to report.docx"
"Insert a 4x3 table with sales data"

VSCode およびその他の MCP 対応ツール

MCP プロトコルをサポートするその他のツールにも、同様の手順で統合できます。MCP サーバーの具体的な設定手順については、各ツールのドキュメントを参照してください。

開発

この MCP サーバーを拡張または変更するには：

1. リポジトリをクローンします。

git clone <repository-url>
cd doc-tools-mcp

2. 依存関係をインストールします。

npm install

3. 開発モードで起動します。

npm run start

4. 本番用にビルドします。

npm run build

MCP 関数の追加

1. src/services/DocumentService.ts に新しいメソッドを追加します
2. src/mcp-server.ts に新しい関数を登録します
3. 必要に応じて型定義を更新します

設定

• デフォルトのポート：8765（変更可能）
• 対応ファイル形式：.docx
• すべてのファイルパスは、絶対パスまたは現在の作業ディレクトリを基準とした相対パスにしてください

ライセンス

MIT

サポート

問題が発生した場合や改善の提案がある場合は、GitHub リポジトリに Issue を登録してください。