MarkItDown MCPとは？
MarkItDown は、ファイルやオフィス文書を Markdown に変換する Microsoft の Python ツールで、メインのリポジトリには約 191,700 の GitHub スターがあります。markitdown-mcp パッケージはそれを MCP サーバーとして包んだもので、AutoGen チームが作りました。
公開するツールは convert_to_markdown(uri) のちょうど 1 つで、http:、https:、file:、data: の URI を受け付けます。既定では stdio で動き、--http フラグを付けると Streamable HTTP と SSE で動き、localhost にバインドします。pip install markitdown-mcp でインストールします。Claude Desktop では、README はリポジトリの Dockerfile から Docker イメージをビルドし、ローカルファイル用に 1 つのフォルダーをマウントすることを勧めています。公式の MCP レジストリには掲載されていません。
パッケージは今もアルファ版の番号です。2025年3月の最初のアルファに続き、2026年10月21日に MarkItDown 0.1.9 とともに 0.0.1a8 が出ました。
MarkItDown MCPのインストール方法
pip install markitdown-mcpMarkItDown MCPは使う価値があるか？
MarkItDown MCP は、コンテキストの面でも費用の面でも、ローカルのエージェントに Office ファイルと PDF を読ませる最も安上がりな方法です。そしてそのセキュリティモデルは、マシン上のすべてを信頼することに等しいものです。ツールが 1 つなのでコンテキストの負担はほぼなく、同じ呼び出しでローカルファイル、URL、インラインのデータを扱えます。
対応形式は幅広く、PDF、Word、PowerPoint、Excel、EPub、HTML、CSV、JSON、XML に加え、EXIF メタデータと OCR による画像、文字起こしによる音声、ZIP アーカイブ、YouTube の URL にも対応します。MCP パッケージは markitdown[all] を固定しているため、必要かどうかにかかわらずすべてのオプションの変換器がインストールされます。Windows ARM64 でのインストール失敗を報告する未解決の issue の背景はこれです。
README のセキュリティの節は珍しく率直です。認証はなく、サーバーはユーザーの権限で動き、convert_to_markdown はそのユーザーが読めるファイルを何でも読め、ネットワーク上の何でも取得できます。これを信頼できない文書を読むエージェントと組み合わせれば、file:///home/you/.ssh/config を変換せよというプロンプトインジェクションの指示は、十分ありうる失敗です。フォルダーを 1 つだけマウントする Docker の方法が妥当な既定ですが、公式のイメージは公開されていないので、イメージは自分でビルドします。
競合より劣るのは、変換の後のすべてです。検索、チャンク分割、ページ選択がないため、300 ページの PDF は丸ごとコンテキストに入り、出力は忠実なレイアウトではなくテキストの構造を目指しています。19 か月と 8 回のアルファを経ても、パッケージのバージョンは今も 0.0.1 で、未解決の issue は VS Code の MCP ギャラリーが今も 0.0.1a4 をインストールすると指摘しています。
真価を発揮する場面
Claude Desktop を使う 30 人の会社の財務アナリスト
四半期ごとの Excel と PowerPoint の資料を、Web アプリにアップロードせずに要約する
Docker イメージをビ ルドし、レポートのフォルダーだけを /workdir にマウントし、Claude Desktop を docker run に向けます。変換は無料でローカルです。コストはモデルのトークンで、ブックはそれぞれ丸ごと届きます。
Claude Agent SDK で文書取り込みエージェントを作る AI エンジニア
顧客がアップロードしたさまざまなファイルを、チャンク分割の前に Markdown にする
コンテナ内で 127.0.0.1:3001 に markitdown-mcp --http を実行し、アップロードを data: URI として渡せば、サーバーはファイルシステムへのアクセスを必要としません。チャンク分割とページ選択は自分のコードで行う必要があります。
開発者のノート PC 向けの MCP サーバーを承認するセキュリティエンジニア
MarkItDown のインストールを許可するかを判断する
ディレクトリを 1 つマウントし、localhost 以外にバインドしない Docker の構成だけを許可します。素の pip install ではユーザーの全ファイルへのアクセス権で動くため、注入された指示を含む文書によって、エージェントがプロジェクト外のファイルを読むおそれがあります。
導入前に確認すること
- 導入
- pip install markitdown-mcp（Python 3.10 以降）を実行し、stdio なら markitdown-mcp、Streamable HTTP と SSE なら markitdown-mcp --http --host 127.0.0.1 --port 3001 を実行します。Claude Desktop では、Dockerfile からイメージをビルドして docker run で起動します。最初の呼び出しまで数分です。
- 連携
- ツールは convert_to_markdown(uri) の 1 つで、http:、https:、file:、data: の URI を受け取ります。何も書き込みませんが、プロセスが届くものは何でも読めます。文書化されたデバッグ手段は MCP Inspector です。
- データとプライバシー
- アカウントなしでローカルに動き、Microsoft には何も送られません。認証はなく、HTTP モードではローカルのどのプロセスやユーザーからも呼び出せます。取得したページと文書は、モデルのコンテキストに入る信頼できないテキストです。
- 大規模利用時のコスト
- MIT で無料で、請求はモデルのトークンです。ツールにページやサイズのパラメーターがないため、長い PDF 1 つで、1 回の呼び出しでコンテキストウィンドウの大部分を占めることがあります。
- 制限
- ページ送り、チャンク分割、検索はなく、レイアウトはテキストの構造に平坦化されます。未解決の issue は、必須の markitdown[all] 依存関係による Windows ARM64 でのインストール失敗と、VS Code のギャラリーが古い 0.0.1a4 をインストールすることを報告しています。
良い点
- ツールが 1 つなので、コンテキストの負担がほぼない
- PDF、Office、EPub、HTML、画像、音声、ZIP を変換
- file、http(s)、data の URI を受け付ける
- MIT ライセンスで、分離用の Dockerfile がある
気になる点
- 認証がなく、ユーザーが読めるファイルは何でも読む
- ページ送りがなく、文書が丸ごとコンテキストに入る
- Docker イメージが公開されておらず、自分でビルドする
- 今も 0.0.1a8 のアルファ版
おすすめの人
PDF や Office 文書をどこにもアップロードせず、ローカルでエージェントに読ませたい開発者。
MarkItDown MCPの代替
MarkItDown MCP：よくある質問
- MarkItDown MCPは使う価値があるか？
- 役に立つ、ツール 1 つの文書変換ツールです。ただし、見せるつもりのファイルだけが見えるコンテナで動かすことが条件です。 評価は5点満点中3.9点です。
- MarkItDown MCPの料金は？
- 無料のオープンソースです（MIT）。
- MarkItDown MCPの欠点は？
- 認証がなく、ユーザーが読めるファイルは何でも読む; ページ送りがなく、文書が丸ごとコンテキストに入る; Docker イメージが公開されておらず、自分でビルドする; 今も 0.0.1a8 のアルファ版.
- MarkItDown MCPは誰に向いているか？
- PDF や Office 文書をどこにもアップロードせず、ローカルでエージェントに読ませたい開発者。
- チームや本番環境でMarkItDown MCPを使うと費用はいくらか？
- MIT で無料で、請求はモデルのトークンです。ツールにページやサイズのパラメーターがないため、長い PDF 1 つで、1 回の呼び出しでコンテキストウィンドウの大部分を占めることがあります。
- MarkItDown MCPは企業データを扱っても安全か？
- アカウントなしでローカルに動き、Microsoft には何も送られません。認証はなく、HTTP モードではローカルのどのプロセスやユーザーからも呼び出せます。取得したページと文書は、モデルのコンテキストに入る信頼できないテキストです。
- MarkItDown MCPの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はFetch (reference server), Filesystem (reference server) 、 Firecrawl MCPです。
回答確認日：2026年10月23日