MCP Documents

🚀 ドキュメントジェネレータMCPサーバ

DOCXおよびPDFドキュメントを作成するためのMCP（Model Context Protocol）サーバで、STDIOとHTTPの両方のトランスポートをサポートしています。

🚀 クイックスタート

uvを使用したクイックスタート

# リポジトリをクローンする
git clone <repository-url>
cd docx_mcp

# uvがまだインストールされていない場合はインストールする
pip install uv

# 環境をセットアップし、依存関係をインストールする
uv venv
uv pip install -e .

# サーバを起動する
uv run python main.py

✨ 主な機能

• DOCXドキュメントの作成 - 段落、テーブル、およびスタイリングを完全にサポート
• PDFドキュメントの作成 - テキストとテーブルを含むPDFを生成
• セッション管理 - ドキュメントを段階的に構築
• 複数のトランスポート - ローカルCLI用のSTDIO、ネットワークアクセス用のHTTP
• クリーンなアーキテクチャ - ドメイン、インフラストラクチャ、およびプレゼンテーション層が分離されている
• Base64サポート - 小さなファイルの場合はドキュメントをBase64で返す
• MCPリソース - URIを介して生成されたドキュメントにアクセス

📦 インストール

pipを使用する場合

# 依存関係をインストールする
pip install -r requirements.txt

# またはpyproject.tomlを使用する場合
pip install -e .

uvを使用する場合（推奨）

# uvで依存関係をインストールする
uv pip install -r requirements.txt

# または編集可能なパッケージとしてインストールする
uv pip install -e .

# uvで仮想環境を作成する
uv venv

💻 使用例

基本的な使用法

STDIOモード（デフォルト）

ローカルCLIツールやデスクトップアプリケーション用です。

# Pythonを直接使用する場合
python main.py

# uvを使用する場合
uv run python main.py

HTTPモード

ネットワークアクセスや複数のクライアント用です。

# Pythonを直接使用する場合
python main.py --transport http --host 0.0.0.0 --port 8000

# uvを使用する場合
uv run python main.py --transport http --host 0.0.0.0 --port 8000

FastMCP CLIを使用する場合

# STDIOモード
fastmcp run presentation/server.py:mcp
# またはuvを使用する場合
uv run fastmcp run presentation/server.py:mcp

# HTTPモード
fastmcp run presentation/server.py:mcp --transport http --port 8000
# またはuvを使用する場合
uv run fastmcp run presentation/server.py:mcp --transport http --port 8000

高度な使用法

シンプルなDOCXを作成する

# MCPクライアントを使用する
result = await client.call_tool("create_docx", {
    "title": "Hello World",
    "paragraphs": ["This is a test document"],
    "return_base64": true
})

ドキュメントを段階的に構築する

# セッションを作成する
session = await client.call_tool("create_document_session", {
    "title": "Report"
})

# コンテンツを追加する
await client.call_tool("add_paragraph", {
    "document_id": session["document_id"],
    "text": "Introduction",
    "style": "bold"
})

# PDFとして保存する
result = await client.call_tool("save_document", {
    "document_id": session["document_id"],
    "format": "pdf"
})

🛠 利用可能なツール

create_docx

一度の呼び出しで完全なDOCXドキュメントを作成します。

{
    "title": "My Document",
    "paragraphs": [
        "Simple text paragraph",
        {
            "text": "Styled paragraph",
            "style": "bold",
            "alignment": "center",
            "font_size": 14
        }
    ],
    "tables": [
        {
            "headers": ["Name", "Age"],
            "data": [["Alice", "30"], ["Bob", "25"]]
        }
    ],
    "return_base64": false
}

create_pdf

DOCXと同様の構造でPDFドキュメントを作成します。

create_document_session

ドキュメントを段階的に構築するためのセッションを開始します。

add_paragraph

セッション内のドキュメントに段落を追加します。

add_table

セッション内のドキュメントにテーブルを追加します。

save_document

セッション内のドキュメントをDOCXまたはPDFとして保存します。

list_documents

現在のセッション内のすべてのドキュメントをリストします。

🔧 技術詳細

アーキテクチャ

docx_mcp/
├── core/               # ドメイン層（ビジネスロジック）
│   ├── models/        # ドキュメント、段落、テーブルのモデル
│   └── interfaces/    # ライターインターフェース
├── infrastructure/     # インフラストラクチャ層
│   ├── docx_writer.py # python-docxの実装
│   └── pdf_writer.py  # fpdf2の実装
├── application/        # アプリケーション層
│   └── services/      # ドキュメントサービス
├── presentation/       # プレゼンテーション層
│   └── server.py      # ツール付きのFastMCPサーバ
└── main.py            # エントリポイント

MCPリソース

ドキュメントはMCPリソースを介してアクセスできます。

• documents://{filename} - ファイル名でドキュメントの内容を取得
• documents://list - すべての生成されたドキュメントをリスト

トランスポートモード

STDIOトランスポート

• 標準入出力を介した通信
• 各クライアントは新しいサーバプロセスを生成
• CLIツールやデスクトップアプリに最適

HTTPトランスポート

• 指定されたポートでのWebサーバ
• 複数の同時クライアントをサポート
• 完全な双方向通信
• URL: http://host:port/mcp

MCPクライアントの設定

Claudeデスクトップの設定

Windows

Claudeデスクトップの設定ファイル（%APPDATA%\Claude\claude_desktop_config.json）に追加します。

macOS/Linux

Claudeデスクトップの設定ファイル（~/.claude/claude_desktop_config.json）に追加します。

{
  "mcpServers": {
    "documents-work": {
      "command": "uv",
      "args": ["run", "python", "C:/Users/batashev/Desktop/MyProjects/docx_mcp/main.py"],
      "env": {}
    }
  }
}

代替設定

相対パスを使用する場合

{
  "mcpServers": {
    "documents-work": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "C:/Users/batashev/Desktop/MyProjects/docx_mcp"
    }
  }
}

uvではなくpipを使用する場合

{
  "mcpServers": {
    "documents-work": {
      "command": "python",
      "args": ["C:/Users/batashev/Desktop/MyProjects/docx_mcp/main.py"]
    }
  }
}

カスタム出力ディレクトリを使用する場合

{
  "mcpServers": {
    "documents-work": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "C:/Users/batashev/Desktop/MyProjects/docx_mcp",
      "env": {
        "OUTPUT_DIR": "C:/Users/batashev/Documents/generated_docs"
      }
    }
  }
}

🧪 テスト

# STDIOモードをテストする
python main.py
# またはuvを使用する場合
uv run python main.py

# HTTPモードをテストする
python main.py --transport http --port 8000
# またはuvを使用する場合
uv run python main.py --transport http --port 8000

# サンプルを実行する
python examples.py
# またはuvを使用する場合
uv run python examples.py

# 別のターミナルで、curlまたはMCPクライアントを使用してテストする
curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{"method": "tools/list"}'

📄 ライセンス

MIT

🤝 コントリビューション

コントリビューションは歓迎されます！ クリーンなアーキテクチャの原則に従い、新機能に対してテストを追加してください。