MarkItDown MCP Server について
MarkItDown MCP Server は、MarkItDown ユーティリティを使って各種ファイルを Markdown に変換する MCP サーバーです。文書の内容をテキスト形式で AI モデルに渡したいユーザーを対象としています。
主な機能
- 01PDF、Word、PowerPoint、Excel の変換
- 02画像の OCR と音声の文字起こし
- 03HTML や CSV、JSON、XML などのテキスト形式の変換
- 04ZIP ファイル内の内容を順に変換
活用シーン
- 01PDF や Office 文書を LLM が読める Markdown に変換
- 02Zed エディターで /md コマンドを使ったファイル変換
MCP 対応
指定したファイルを Markdown に変換する /md コマンドを MCP クライアントに提供する MCP サーバーです。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MarkItDown MCP サーバー
MarkItDown ユーティリティを使用して、さまざまなファイル形式を Markdown に変換する Model Context Protocol(MCP)サーバーです。
対応形式
- PowerPoint
- Word
- Excel
- 画像(EXIF メタデータと OCR)
- 音声(EXIF メタデータと音声の文字起こし)
- HTML
- テキストベースの形式(CSV、JSON、XML)
- ZIP ファイル(内容を順に処理)
インストール
Smithery 経由でインストール
Smithery 経由で、Claude Desktop 用の MarkItDown MCP Server を自動的にインストールするには:
npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude
手動インストール
- このリポジトリをクローンします
- 依存関係をインストールします:
uv install
使用方法
MCP サーバーとして
このサーバーは、任意の MCP クライアントに統合できます。以下に例を示します:
Zed Editor
settings.json に以下を追加します:
"context_servers": {
"markitdown_mcp": {
"settings": {},
"command": {
"path": "uv",
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown-mcp"
]
}
}
}
コマンド
サーバーは以下の MCP コマンドに応答します:
/md <file>- 指定したファイルを Markdown に変換します
例:
/md document.pdf
対応 MCP クライアント
modelcontextprotocol.io/clients に掲載されている MCP 準拠の任意のクライアントで動作します。以下を含みます:
- Zed Editor
- その他の MCP 対応エディターおよびツール
ライセンス
MIT License。詳細は LICENSE をご覧ください。
謝辞
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。