MarkItDown｜PDFやWord・ExcelをMarkdown化してClaudeに読ませるMCPサーバー

Claudeに手元のPDFやWordファイルをそのまま渡しても、レイアウト崩れや文字化けでうまく内容を拾ってくれない、という経験がある人は少なくないはずだ。今回紹介するmicrosoft/markitdownは、PDF・Word・Excel・PowerPoint・画像・音声・HTML・CSV・ZIP・ePubなど幅広いファイル形式をMarkdown形式に変換するPython製のオープンソースツールで、GitHub上で17万を超えるスターを集めている。単体のコマンドラインツールとしても使えるが、同リポジトリに含まれるmarkitdown-mcpパッケージを使うと、MCP（Model Context Protocol）サーバーとしてClaude Desktopなどに組み込み、ファイル変換をClaudeとの対話の中で直接行わせることができる。過去の紙資料や取引先から届くOffice文書をAIに読み込ませて整理したい、という個人事業主の実務ニーズに合うツールだ。

MarkItDownとは
導入方法
注意点
参考記事

MarkItDownとは

MarkItDownはMicrosoftが公開しているPythonユーティリティで、「LLMや文章分析パイプラインで使うために、様々なファイルをMarkdownに変換する軽量ツール」として設計されている。PDF、PowerPoint、Word、Excelに加え、画像（EXIFメタデータとOCR）、音声（メタデータと文字起こし）、HTML、CSV、JSON、XML、ZIP、YouTube URL、ePubといった幅広い形式に対応する。ライセンスはMITで、リポジトリは現在も活発にコミットが続いている。

導入方法

MarkItDown本体はpipでインストールする。対応形式をフルに使うには[all]を付ける。Python 3.10以上が前提条件になっている。

pip install 'markitdown[all]'

ソースから導入する場合は次の手順になる。

git clone git@github.com:microsoft/markitdown.git
cd markitdown
pip install -e 'packages/markitdown[all]'

MCPサーバーとしてClaudeから直接呼び出すには、別パッケージのmarkitdown-mcpを追加でインストールする。

pip install markitdown-mcp

インストール後、markitdown-mcpコマンドを実行するとSTDIOモードでサーバーが起動する。Claude Desktopから使う場合は、設定ファイル（claude_desktop_config.json）のmcpServers項目に次のように追記する。READMEにはDockerコンテナ経由での起動例が示されている。

{
  "mcpServers": {
    "markitdown": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "markitdown-mcp:latest"]
    }
  }
}

ローカルファイルを変換対象にする場合は、コンテナへのディレクトリマウント設定を別途加える必要がある。ネットワーク経由で使いたい場合はHTTP/SSEモードでも起動でき、その際はmarkitdown-mcp --http --host 127.0.0.1 --port 3001のようにホストとポートを指定する。

注意点

Python 3.10以上が前提条件になっている。
markitdown-mcpはhttp:、https:、file:、data:のURIに対応しており、リモートURLを変換対象にすることもできる。外部サイトへの通信が発生し得る点は把握しておく必要がある。
HTTP/SSEモードで起動する場合、READMEは「localhost以外のインターフェースにバインドしないこと」を明記している。ネットワーク越しに公開する構成にすると、意図しないアクセスを許すおそれがある。
MarkItDown本体は「現在のプロセスの権限でI/Oを行う」とREADMEに記載があり、信頼できないファイルやユーザー入力を無制限に渡す運用は避けたほうがよい、という注意書きがある。
現時点のREADMEにAPIキーなど認証情報の設定に関する記載はない。ただし変換対象に取引先情報や契約書などの機密文書を含める場合は、その内容がClaudeとのやり取りに渡る点を踏まえて運用を検討する必要がある。

今後実際に使ってみて、使い勝手を別記事で報告する予定。