Markdownify MCPサーバー

👁 markdownify mcp logo

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

機能

• 複数のファイル形式をMarkdownに変換:

  • PDF

  • 画像

  • 音声 (文字起こし付き)

  • DOCX

  • XLSX

  • PPTX

• WebコンテンツをMarkdownに変換:

  • YouTube動画の文字起こし

  • Bing検索結果

  • 一般的なWebページ

• 既存のMarkdownファイルの取得

Related MCP server: Markdownify MCP Server - UTF-8 Enhanced

はじめに

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"
 ]
 }
 }
}

環境変数

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

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: Webページを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ファイルを参照してください。

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• audio-to-markdownB
• bing-search-to-markdownC
• docx-to-markdownC
• get-markdown-fileC
• image-to-markdownB
• pdf-to-markdownC
• pptx-to-markdownC
• webpage-to-markdownC