Consistent Docx MCP

🚀 ドキュメント形式変換MCPサーバー

このサーバーは、Node.jsとTypeScriptをベースに構築されたMCP (Model-Context Protocol) サーバーです。大規模言語モデル (LLM) 向けに、ドキュメント形式を維持したままmdとdocxを相互変換するツールを提供します。

本プロジェクトは、npx で直接実行できるコマンドラインツールとしてパッケージ化されており、本当に「すぐに使える」ものとなっています。

✨ 主な機能

docx_to_markdown

• 機能：.docx ファイルをローカルで純粋なMarkdownテキストに変換します。
• 説明：指定されたパスの .docx ファイルを読み取り、その純粋なテキスト内容を抽出します。
• パラメータ：path (文字列) - 入力する .docx ファイルの絶対パス。

markdown_to_docx

• 機能：Markdown内容と参照スタイルに基づいて、新しい .docx ファイルを生成します。
• 説明：あなたのMarkdownテキストを、参照用の .docx ファイルのスタイルに沿って、形式が一致した新しいドキュメントを生成します。
• パラメータ：
  • markdown (文字列) - 変換するMarkdown内容。
  • referencePath (文字列) - スタイルテンプレートとして使用する .docx ファイルの絶対パス。
  • outputPath (文字列) - 生成された .docx ファイルを保存する絶対パス。

🚀 クイックスタート (NPX方式)

このサーバーは、独立したコマンドラインツールとして、npx を通じてMCPに対応した任意のクライアントで設定することができます。この方法では、手動でのダウンロード、インストール、またはコンパイルは不要です。

1. クライアント設定を開く：MCPクライアントの設定ファイル（例えば、Claude for Desktopの claude_desktop_config.json）を見つけて開きます。

2. サーバー設定を追加する：mcpServers オブジェクト内に、以下の設定を追加します。

   ⚠️ 重要提示

   --api-key の値を、あなた自身の実際のAPIキーに置き換える必要があります。APIキーは、公众号「偷偷成精的咸鱼」に注目して作者に連絡することで取得できます。

   {
     "mcpServers": {
       "doc-converter": {
         "command": "npx",
         "args": [
           "consistent-docx-mcp",
           "--api-key",
           "YOUR-API-KEY-HERE"
         ]
       }
     }
   }
   

   • consistent-docx-mcp：これは、プロジェクトをnpmリポジトリに公開する際に使用するパッケージ名です。
   • --api-key：これは、サーバーにAPIキーを渡す標準的な方法です。後ろの値をあなたの有効なキーに置き換えてください。

3. クライアントを再起動する：設定ファイルを保存し、MCPクライアントを完全に閉じてから再起動します。

これで、クライアントは自動的に npx を通じてこのツールをダウンロードして実行し、クライアント内で直接 docx_to_markdown と markdown_to_docx を呼び出すことができます。

📚 ドキュメント