Claude Document MCP Server について
Claude Document MCP Server は、Claude Desktop から Word、Excel、PDF ファイルの作成・編集・変換を行う軽量な MCP サーバーです。Claude にオフィス文書の作業を任せたいユーザー向けです。
主な機能
- 01Word の段落と見出しの作成・編集
- 02Excel のセル、行、列、シートの編集
- 03CSV とテキストファイルの Excel・Word への変換
- 04Word 文書から PDF への変換
- 05操作ログのファイル出力
活用シーン
- 01テキストから Word 文書を生成
- 02Claude による既存 Excel スプレッドシートの修正
- 03CSV データから Excel ファイルへの変換
MCP 対応
文書操作機能を MCP ツールとして提供し、機能説明をリソースとして公開することで、Claude Desktop などの MCP クライアントから利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Claude Document MCP Server
Claude Desktop で Microsoft Word、Excel、PDF ファイルの文書操作を行える Model Context Protocol(MCP)サーバーです。
機能
Microsoft Word の操作
- テキストから新しい Word 文書を作成
- 既存の Word 文書を編集(段落や見出しの追加・編集・削除)
- テキストファイル(.txt)を Word 文書に変換
Excel の操作
- JSON または CSV 形式のテキストから新しい Excel スプレッドシートを作成
- 既存の Excel ファイルを編集(セルや範囲の更新、行・列・シートの追加・削除)
- CSV ファイルを Excel に変換
PDF の操作
- テキストから新しい PDF ファイルを作成
- Word 文書を PDF ファイルに変換
セットアップ
この MCP サーバーを使用するには、Python 3.10 以降が必要です。
Smithery 経由でのインストール
Smithery 経由で Claude Desktop 用の Claude Document MCP Server を自動的にインストールするには、次を実行します。
npx -y @smithery/cli install @alejandroBallesterosC/document-edit-mcp --client claude
自動セットアップ(推奨)
セットアップスクリプトを実行すると、依存関係のインストールと Claude Desktop の設定が自動的に行われます。
git clone https://github.com/alejandroBallesterosC/document-edit-mcp
cd document-edit-mcp
./setup.sh
これにより、次の処理が行われます。
- 仮想環境を作成
- 必要な依存関係をインストール
- Claude Desktop 用にサーバーを設定
- 必要なディレクトリを作成
手動セットアップ
手動でセットアップする場合は、次の手順に従ってください。
- 依存関係をインストールします。
cd claude-document-mcp
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
pip install -e .
- Claude Desktop を設定します。
claude_desktop_config.json ファイルを次の場所にコピーします。
- Mac:
~/Library/Application Support/Claude/ - Windows:
%APPDATA%\Claude\
- Claude Desktop を再起動します。
Model Context Protocol の統合
このサーバーは Model Context Protocol の仕様に準拠しており、Claude Desktop に文書操作機能を提供します。
- ツール:Word、Excel、PDF の操作機能を提供します
- リソース:機能に関する情報を提供します
- プロンプト:(現在は実装されていません)
API リファレンス
Microsoft Word
Word 文書の作成
create_word_document(filepath: str, content: str) -> Dict
Word 文書の編集
edit_word_document(filepath: str, operations: List[Dict]) -> Dict
TXT を Word に変換
convert_txt_to_word(source_path: str, target_path: str) -> Dict
Excel
Excel ファイルの作成
create_excel_file(filepath: str, content: str) -> Dict
Excel ファイルの編集
edit_excel_file(filepath: str, operations: List[Dict]) -> Dict
CSV を Excel に変換
convert_csv_to_excel(source_path: str, target_path: str) -> Dict
PDF ファイルの作成
create_pdf_file(filepath: str, content: str) -> Dict
Word を PDF に変換
convert_word_to_pdf(source_path: str, target_path: str) -> Dict
ログ
トラブルシューティング用に、サーバーはすべての操作をコンソールと logs/document_mcp.log ファイルの両方に記録します。
ライセンス
MIT
コントリビューション
コントリビューションを歓迎します。お気軽に Pull Request を送信してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
