mcpField
M
MarkItDown MCP Server

MarkItDown MCP Server

ローカル
github.com/KorigamiK生産性8844 週間前に更新

MarkItDown MCP Server について

MarkItDown MCP Server は、MarkItDown ユーティリティを使って各種ファイルを Markdown に変換する MCP サーバーです。文書の内容をテキスト形式で AI モデルに渡したいユーザーを対象としています。

主な機能

  1. 01PDF、Word、PowerPoint、Excel の変換
  2. 02画像の OCR と音声の文字起こし
  3. 03HTML や CSV、JSON、XML などのテキスト形式の変換
  4. 04ZIP ファイル内の内容を順に変換

活用シーン

  1. 01PDF や Office 文書を LLM が読める Markdown に変換
  2. 02Zed エディターで /md コマンドを使ったファイル変換

MCP 対応

指定したファイルを Markdown に変換する /md コマンドを MCP クライアントに提供する MCP サーバーです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"markitdown_mcp_server": {
"command": "npx",
"args": [
"-y",
"@smithery/cli"
]
}
}
}
起動コマンドnpx -y @smithery/cli

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@smithery/cli

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

MarkItDown MCP サーバー

smithery badge

MarkItDown ユーティリティを使用して、さまざまなファイル形式を Markdown に変換する Model Context Protocol(MCP)サーバーです。

MarkItDown Server MCP server

対応形式

  • PDF
  • 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
手動インストール
  1. このリポジトリをクローンします
  2. 依存関係をインストールします:
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 をご覧ください。

謝辞

https://github.com/microsoft/markitdown#readme

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。