Word Document Tools

🚀 ワードツールMCPサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装し、AIによるWord文書操作機能を提供します。MCPプロトコルを実装することで、AIアプリケーションが自然言語でWord文書の作成、編集、管理を行えるようになります。

✨ 主な機能

• MCPプロトコルの完全実装
• 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文書を操作できます：

"report.docxという名前の新しい文書を作成する"
"report.docxに'月度報告'というタイトルを追加する"
"販売データを含む4x3の表を挿入する"

VSCodeとその他のMCP対応アプリケーション

他のMCPプロトコル対応ツールとの統合手順は類似しています。具体的な設定方法はこちらを参照してください。

🔧 技術詳細

• このプロジェクトはNode.jsとJavaScriptで記述されており、この技術スタックに精通した開発者に適しています。
• サーバーの核心ロジックはserver.jsファイルにあり、様々なMCPコマンドを処理します。
• 各機能モジュール（文書作成、段落追加など）は独立して実装されており、保守と拡張が容易です。

📚 ドキュメント

設定

• サーバーはデフォルトで8765ポートを監視します。ポートを変更する場合は、server.jsの対応する設定を変更してください。
• カスタムプラグインシステムをサポートしており、開発者がさらなる機能を拡張できます。具体的な方法は拡張ドキュメントを参照してください。

サンプル

以下は簡単な使用例です：

1. サーバーをインストールします：

npm install @puchunjie/doc-tools-mcp

2. サーバーを起動します：

npx @puchunjie/doc-tools-mcp

3. ブラウザで http://localhost:8765 にアクセスすると、提供されているAPIインターフェースを見ることができます。

問題とサポート

問題が発生した場合は、GitHubリポジトリを訪問してドキュメントを確認するか、ISSUEを提出してください。アクティブな開発者コミュニティがサポートを提供します。

📄 ライセンス

このプロジェクトはMITライセンスに従います。詳細はLICENSEファイルを参照してください。