groupdocs-markdown-mcp

GroupDocs.Markdown MCP サーバー

GroupDocs.Markdown を、Claude、Cursor、GitHub Copilot、その他の MCP エージェントから呼び出せるツールとして提供する MCP サーバーです。ドキュメントを整理されたクリーンな Markdown に変換します。

インストール

ワンクリックインストールでは、サポートされている設定がすべてあらかじめ入力されます。インストール後にプレースホルダーのドキュメントフォルダーを編集してください（出力先は既定で同じフォルダーです）。GROUPDOCS_LICENSE_PATH が空の場合は評価モードで実行されます。制限を解除するには、ライセンスへのパスを指定してください。

その他のクライアント - Claude Code、Codex CLI、Visual Studio 2022、Cursor、Windsurf、Cline、JetBrains Rider 用の設定は install/generated/ にあります。

.NET 10 SDK が必要です。

dnx で直接実行（推奨 — インストール不要）：

dnx GroupDocs.Markdown.Mcp --yes

実行するたびに最新の安定版リリースが取得されます。特定のバージョンを固定するには（共有設定や CI での使用を推奨）、@<version> を追加します。

dnx [email protected] --yes

または、グローバル dotnet ツールとしてインストール：

dotnet tool install -g GroupDocs.Markdown.Mcp
groupdocs-markdown-mcp

または、Docker で実行：

docker run --rm -i \
  -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-markdown/markdown-net-mcp:latest

どのプラットフォームでも、ネイティブの前提条件は不要です。基盤となる GroupDocs.Markdown エンジンは、自己完結型の SkiaSharp ネイティブアセットを使用して画像を含むドキュメントをレンダリングするため、dnx、グローバルツール、Docker イメージのいずれも、追加の apt／brew のセットアップなしで実行できます。

利用可能な MCP ツール

ツール	説明
ConvertToMarkdown	ドキュメント（PDF、DOCX、XLSX、EPUB、MOBI など）を、整った構造の Markdown に変換し、.md をストレージに保存します。画像はデフォルトで base64 として埋め込まれます。
GetDocumentInfo	変換せずに、ファイル形式、ページ数、タイトル、作成者、暗号化フラグを JSON として返します。

Markdown からドキュメントへの逆変換は、基盤となる GroupDocs.Markdown 26.3.0 エンジンではまだ実装されていません（MarkdownConverter.FromMarkdownString は NotImplementedException をスローします）。そのため、このサーバーは ComposeFromMarkdown ツールを提供していません。現在 Markdown から DOCX / PDF / HTML を出力する必要がある場合は、 .md ソースファイルを使用して GroupDocs.Conversion MCP をご利用ください。

AI エージェント向けのプロンプト例

• 「report.pdf を Markdown に変換して」
• 「business-plan.docx を、画像を base64 として埋め込んだ Markdown にエクスポートして」
• 「contract.pdf の 1〜3 ページを Markdown に変換して。テキストのみで、画像はスキップして」
• 「business-plan.pdf のページ数はいくつですか？」
• 「cost-analysis.xlsx の形式と作成者を教えて」

ライセンス

MCP サーバー自体は MIT ライセンスですが、基盤となる GroupDocs.Markdown エンジンを本番環境で使用するにはライセンスが必要です。 ライセンスがない場合、サーバーは評価モードで動作します。

• 出力が制限される場合があり、評価に関する通知が含まれます。
• 1 つのサーバープロセスで開けるドキュメントは最大 15 件です。上限を超える呼び出しは、サーバーを再起動するまで評価上限エラーになります。

サーバーにライセンスを適用する方法は 2 つあります。

ライセンスファイル — GROUPDOCS_LICENSE_PATH に GroupDocs.Total.lic のパスを設定します。オフラインで動作します。

従量課金 — GROUPDOCS_METERED_PUBLIC_KEY と GROUPDOCS_METERED_PRIVATE_KEY の両方を設定します。実際に処理した分だけ課金されます。利用状況が断続的で事前に予測しにくい AI エージェントに適しています。従量課金キーのペアとライセンスファイルの両方が設定されている場合は、従量課金が優先され、ライセンスファイルは無視されます。

従量課金モードには外部への接続が必要です。 使用状況は GroupDocs サーバーに報告されるため、外部ネットワークから隔離された環境やファイアウォールで保護された環境では、その外向き通信を許可する必要があります。許可できない場合は、代わりにライセンスファイルをご利用ください。

get_license_status ツールをいつでも呼び出して、現在のモードを確認できます。また、従量課金の場合は、消費量と残りのクレジットも確認できます。

秘密鍵を設定ファイルに記載しない方法

従量課金の秘密鍵は機密情報です。MCP クライアントの設定はディスク上に通常のファイルとして保存され、プロジェクト単位の .mcp.json は慣例としてコミットされるため、次の順に方法を検討してください。

1. OS の環境変数に設定し、設定ファイルには一切記載しないでください。 stdio MCP サーバーはクライアントの環境変数を引き継ぐため、どのクライアントでも利用できます。 macOS では、Finder から起動したアプリはシェルのエクスポート設定を引き継がない点に注意してください。launchctl setenv を使用するか、ターミナルからクライアントを起動してください。
2. クライアントが対応している場合は、間接的に参照してください（Claude Code は ${VAR} を展開し、VS Code は ${env:VAR} と ${input:...} を使用します）。
3. ユーザー単位の設定ファイル（例：~/.claude.json）に値を直接記載する方法は、個人開発者であれば許容されます。
4. プロジェクト単位の .mcp.json にキーを直接記載してコミットすることは、絶対にしないでください。

Docker の場合は、値をファイルに書き込まずに渡してください。

docker run --rm -i \
  -e GROUPDOCS_METERED_PUBLIC_KEY -e GROUPDOCS_METERED_PRIVATE_KEY \
  -v /path/to/documents:/data \
  ghcr.io/groupdocs-markdown/markdown-net-mcp:latest

ライセンスファイルで制限を解除するには、次のリンクをご利用ください。

• 30 日間の一時ライセンスを無料で取得
• ライセンスを購入 | 製品ページ

設定

変数	説明	デフォルト
GROUPDOCS_MCP_STORAGE_PATH	入力ファイルと出力ファイルのベースフォルダー	現在のディレクトリ
GROUPDOCS_MCP_OUTPUT_PATH	(任意) 出力ファイル用の個別フォルダー	GROUPDOCS_MCP_STORAGE_PATH
GROUPDOCS_LICENSE_PATH	GroupDocs ライセンスファイルのパス	（評価モード）
GROUPDOCS_METERED_PUBLIC_KEY	従量制の公開キー。秘密キーも必要です。ライセンスファイルより優先されます	（未設定）
GROUPDOCS_METERED_PRIVATE_KEY	従量制の秘密キー。シークレット — ライセンスを参照してください	（未設定）

評価モード（ライセンスなし）では、変換後の Markdown に制限が適用され、 評価に関する注意書きが含まれる場合があります。制限のない出力を得るには、 GROUPDOCS_LICENSE_PATH を指定してください。

Claude Desktop での使用

{
  "mcpServers": {
    "groupdocs-markdown": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Markdown.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}

特定のバージョンに固定するには、args の "GroupDocs.Markdown.Mcp" を "[email protected]" に置き換えてください。予期しないアップグレードを 避けるため、共有する設定やコミットする設定ではバージョンの固定をおすすめします。

VS Code / GitHub Copilot での使用

NuGet.org のパッケージページには、 すぐに使える mcp.json スニペットが用意されています。これを .vscode/mcp.json に 直接コピーしてください。

または、.vscode/mcp.json に手動で追加します。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "storage_path",
      "description": "Base folder for input and output files.",
      "password": false
    }
  ],
  "servers": {
    "groupdocs-markdown": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Markdown.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
      }
    }
  }
}

上記と同じルールでバージョンを固定できます。特定のリリースに固定するには、 "GroupDocs.Markdown.Mcp" を "[email protected]" に置き換えてください。

Docker Compose での使用

cd docker
docker compose up

docker/docker-compose.yml を編集して、ボリュームがローカルのドキュメントフォルダーを指すようにしてください。

ドキュメントとガイド

ステップごとのデプロイガイドと、公開パッケージの統合テストスイートは、 関連リポジトリ GroupDocs.Markdown.Mcp.Testsにあります。

• NuGet からインストール — dnx、グローバルツール、バージョン固定と常に最新のバージョンの違い
• Docker 経由で実行
• MCP レジストリで確認
• Claude Desktop で使用
• VS Code / GitHub Copilot で使用
• 統合テストを実行

このリポジトリでは、CI で Linux、macOS、Windows 上の公開済み NuGet アーティファクトを使い、告知されているすべてのツールをテストしています。そのため、 上記のスニペットは各リリースでエンドツーエンドの検証が行われます。

ライセンス

MIT — LICENSE を参照してください