Markdownify MCP Server
Markdownify MCPサーバー

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
はじめに
このリポジトリをクローンします
依存関係をインストールします:
bun installpreinstallステップで、.venvにPython仮想環境を作成し、markitdown[all]をインストールします。プロジェクトをビルドします:
bun run buildサーバーを起動します:
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"
]
}
}
}環境変数
すべてのパスは適切なデフォルト値に設定されています。デフォルト値がインストール環境に合わない場合にのみ上書きしてください。
変数 | デフォルト | 目的 |
|
|
|
|
|
|
| 未設定(制限なし) | サーバーが読み取りを許可されるディレクトリのパス区切りリスト(POSIXでは |
| 未設定 |
|
Dockerでの使用
ビルドと実行:
docker build -t markdownify-mcp .
docker run --rm -i \
-v "$HOME/Documents:/data:ro" \
-e MD_ALLOWED_PATHS=/data \
markdownify-mcpDocker 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 toolsaudio-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
Scored across 10 tools
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.
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.
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.
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
Related MCP Connectors
Convert PDF, Word, Excel, PowerPoint, e-mails and web pages to clean Markdown for LLMs.
Documents to Markdown: PDF, DOCX, PPTX, XLSX, HTML. Scanned PDF pages read by AI.
Convert PDFs, Office docs, websites and audio into AI-ready Markdown, then search and ask your docs.
Documents to Markdown/PDF, OCR, video and audio transcripts, TTS, screenshots, domains, frames.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConverts 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 npm14MIT
- AlicenseAqualityDmaintenanceConverts various file types (PDF, images, audio, DOCX, XLSX, PPTX) and web content (YouTube videos, web pages, Bing search results) into Markdown format for easy reading and sharing.10MIT
- AlicenseNot gradedqualityDmaintenanceConverts 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.3MIT
- AlicenseNot gradedqualityDmaintenanceConverts 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