Markdownify MCP Server

Markdownify MCP サーバー

Markdownify は、さまざまなファイル形式やウェブコンテンツを Markdown 形式に変換する Model Context Protocol（MCP）サーバーです。PDF、画像、音声ファイル、ウェブページなどを、読みやすく共有しやすい Markdown テキストに変換するツールを提供します。

機能

• 複数のファイル形式を Markdown に変換します。
  • PDF
  • 画像
  • 音声（文字起こし付き）
  • DOCX
  • XLSX
  • PPTX
• ウェブコンテンツを Markdown に変換します。
  • YouTube 動画の文字起こし
  • Bing の検索結果
  • 一般的なウェブページ
• 既存の Markdown ファイルを取得します。

はじめに

1. このリポジトリをクローンします。

2. 依存関係をインストールします。

   bun install
   

   preinstall ステップで .venv に Python 仮想環境を作成し、markitdown[all] をインストールします。

3. プロジェクトをビルドします。

   bun run build
   

4. サーバーを起動します。

   bun start
   

開発

• bun run dev を使って、TypeScript コンパイラーをウォッチモードで起動します。
• src/server.ts を変更して、サーバーの動作をカスタマイズします。
• src/tools.ts でツールを追加または変更します。

デスクトップアプリでの使用

このサーバーをデスクトップアプリに統合するには、アプリのサーバー設定に次の内容を追加します。

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

環境変数

すべてのパスには適切なデフォルト値が設定されています。インストール環境にデフォルト値が合わない場合にのみ、上書きしてください。

変数	デフォルト値	用途
MARKITDOWN_PATH	<project>/.venv/bin/markitdown、次に PATH 上の markitdown	markitdown 実行ファイルの絶対パスです。バンドルされた venv を使わず、システム全体に markitdown をインストールした場合（例：pipx install "markitdown[pdf]"）に設定します。
REPOMIX_PATH	<project>/node_modules/.bin/repomix、次に PATH 上の repomix	git-repo-to-markdown が使用する repomix 実行ファイルの絶対パスです。
MD_ALLOWED_PATHS	未設定（制限なし）	サーバーによる読み取りを許可するディレクトリを、パス区切り文字で区切って列挙します（POSIX では :、Windows では ;）。設定すると、すべてのファイル入力ツール（pdf-to-markdown、get-markdown-file など）は、これらのディレクトリ外のパスを拒否します。
MD_SHARE_DIR	未設定	MD_ALLOWED_PATHS の非推奨エイリアス（単一ディレクトリ）です。後方互換性のため、引き続き使用できます。

Docker での使用

ビルドして実行します。

docker build -t markdownify-mcp .
docker run --rm -i \
  -v "$HOME/Documents:/data:ro" \
  -e MD_ALLOWED_PATHS=/data \
  markdownify-mcp

Docker MCP カタログ（mcp/markdownify）に関する注意事項：

• サーバーに読み取らせたいホストディレクトリをコンテナにマウントし、ツールにはコンテナ内のパスを渡してください（例：/Users/you/Documents/foo.pdf ではなく /data/foo.pdf）。
• MD_ALLOWED_PATHS にマウントしたディレクトリをコロン区切りで設定し、バインドマウントと一致する読み取り範囲をサーバーに適用させてください。
• 公開されている Docker イメージにインストールされるのは markitdown[pdf] のみです。音声の文字起こしと画像 OCR（audio-to-markdown、image-to-markdown）には [all] の追加機能が必要なため、軽量イメージでは失敗します。すべての機能を利用するには、ローカルインストール（bun install）を使用してください。

利用可能なツール

• youtube-to-markdown：YouTube 動画を Markdown に変換します。

• pdf-to-markdown：PDF ファイルを Markdown に変換します。

• bing-search-to-markdown：Bing の検索結果を Markdown に変換します。

• webpage-to-markdown：ウェブページを Markdown に変換します。

• image-to-markdown：画像をメタデータ付きで Markdown に変換します。

• audio-to-markdown：音声ファイルを文字起こし付きで Markdown に変換します。

• docx-to-markdown：DOCX ファイルを Markdown に変換します。

• xlsx-to-markdown：XLSX ファイルを Markdown に変換します。

• pptx-to-markdown：PPTX ファイルを Markdown に変換します。

• get-markdown-file：既存の Markdown ファイルを取得します。ファイル拡張子は *.md または *.markdown で終わる必要があります。

  任意：MD_ALLOWED_PATHS を設定して、すべてのファイル入力ツールで使用できるディレクトリを制限できます。例：MD_ALLOWED_PATHS=/data/in:/data/out bun start。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。詳細については、LICENSE ファイルをご覧ください。