Skip to main content
Glama

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

はじめに

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

Available Tools

10 tools
audio-to-markdownC

Convert an audio file to markdown, including transcription if possible

Inputs: filepath (required).

bing-search-to-markdownC

Convert a Bing search results page to markdown

Inputs: url (required).

docx-to-markdownC

Convert a DOCX file to markdown

Inputs: filepath (required).

get-markdown-fileC

Get a markdown file by absolute file path

Inputs: filepath (required).

image-to-markdownC

Convert an image to markdown, including metadata and description

Inputs: filepath (required).

pdf-to-markdownC

Convert a PDF file to markdown

Inputs: filepath (required).

pptx-to-markdownC

Convert a PPTX file to markdown

Inputs: filepath (required).

webpage-to-markdownC

Convert a webpage to markdown

Inputs: url (required).

xlsx-to-markdownC

Convert an XLSX file to markdown

Inputs: filepath (required).

youtube-to-markdownC

Convert a YouTube video to markdown, including transcript if available

Inputs: url (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose focused on converting a specific input format (audio, Bing search, DOCX, etc.) to markdown. The descriptions specify unique source types, making it impossible to confuse which tool to use for a given conversion task.

    Naming Consistency5/5

    All tools follow a consistent pattern of 'source-to-markdown' (e.g., audio-to-markdown, docx-to-markdown). This uniform naming convention makes it easy to predict tool names and understand their functions at a glance.

    Tool Count5/5

    With 10 tools, the server covers a comprehensive range of common input formats (audio, documents, web content, spreadsheets, presentations, etc.) for markdown conversion. This count is well-scoped for the domain, providing thorough coverage without being overwhelming.

    Completeness5/5

    The tool set offers complete coverage for converting various media and file types to markdown, including audio, images, documents, webpages, and videos. There are no obvious gaps; each tool handles a distinct input format, ensuring agents can convert any supported source without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts various file types (documents, images, audio, web content) to markdown format without requiring Docker, supporting PDF, Word, Excel, PowerPoint, images, audio files, web URLs, and more.
      397 npm
      14
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts documents, webpages, and media files into markdown for AI assistants using Microsoft's MarkItDown and Crawl4AI. It enables tools to read PDFs, Office files, and JavaScript-rendered websites with support for OCR and image extraction.
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Converts files (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube transcripts, Bing search, general pages) to Markdown via the Model Context Protocol.
      Apache 2.0