Markdownify MCP サーバー

「Markdownify」MCPサーバーは何をする？

Markdownify MCPサーバーは、様々なファイル形式やウェブコンテンツをMarkdown形式に変換するためのModel Context Protocol (MCP)サーバーです。AIアシスタントと外部データソースの橋渡し役として、ドキュメント・画像・音声・ウェブページなどを読みやすく共有可能なMarkdownテキストへ変換しやすくします。Markdownifyが提供する各種ツールにより、PDFからのテキスト抽出、YouTube動画トランスクリプトの取得、音声ファイルの文字起こし変換などが可能です。これにより、複雑または非構造化な情報源から標準化された機械可読コンテンツを提供し、AI対応アプリケーションによる利用・要約・処理を容易にします。

プロンプト一覧

※リポジトリやドキュメントに明示的なプロンプトテンプレートは記載されていません。

リソース一覧

※リポジトリやドキュメントに明示的なMCPリソースの記載はありません。

ツール一覧

• youtube-to-markdown: YouTube動画のトランスクリプトを抽出・整形しMarkdown化します。
• pdf-to-markdown: PDF書類をMarkdownテキストに変換します。
• bing-search-to-markdown: Bing検索結果をMarkdownサマリーに変換します。
• webpage-to-markdown: 一般的なウェブページの内容をMarkdown形式へ変換します。
• image-to-markdown: 画像とメタデータをMarkdownに変換します。
• audio-to-markdown: 音声ファイルを文字起こしし、Markdown形式に変換します。
• docx-to-markdown: Microsoft Word (DOCX)ファイルをMarkdownに変換します。
• xlsx-to-markdown: Excel (XLSX)ファイルをMarkdownの表またはテキストへ変換します。
• pptx-to-markdown: PowerPoint (PPTX)プレゼンテーションをMarkdownに変換します。
• get-markdown-file: 指定ディレクトリから既存のMarkdownファイル（.mdまたは.markdown拡張子）を取得します。

このMCPサーバーのユースケース

• ナレッジ管理のためのドキュメント変換: PDF、DOCX、PPTX、XLSXなどをMarkdown化し、ドキュメントシステムやWiki、ナレッジベースへ統合。検索や編集も容易に。
• ウェブコンテンツの要約: ウェブページ、Bing検索結果、YouTube動画のトランスクリプトから情報を抽出・標準化し、AIによる分析・要約・レポート作成で活用。
• 音声・画像処理: ポッドキャストや会議音声のMarkdown文字起こし、画像データのMarkdownリポジトリ格納・再利用・アクセシビリティ向上。
• Markdown取得・共有: 既存Markdownドキュメントを集中ディレクトリから安全に取得・共有し、コラボレーションを支援。
• AIアシスタントの文脈化: 多様な実世界データを一貫したフォーマットでAIモデルが利用でき、最新・文脈的な回答やアクションが可能に。

セットアップ方法

Windsurf

1. Node.jsとpnpmがインストールされていることを確認。
2. リポジトリをクローンし依存関係をインストール:

   git clone https://github.com/zcaceres/markdownify-mcp.git
   cd markdownify-mcp
   pnpm install
   

3. プロジェクトをビルド:

   pnpm run build
   

4. Windsurfの設定に追加:

   {
     "mcpServers": {
       "markdownify": {
         "command": "node",
         "args": [
           "/absolute/path/to/markdownify-mcp/dist/index.js"
         ],
         "env": {
           "UV_PATH": "/path/to/uv"
         }
       }
     }
   }
   

5. 設定を保存しWindsurfを再起動。アプリ画面でサーバーが稼働しているか確認してください。

APIキーの安全な管理例:

{
  "env": {
    "API_KEY": "${API_KEY}"
  },
  "inputs": {
    "api_key": "${API_KEY}"
  }
}

Claude

1. Node.jsとpnpmをインストール。
2. 上記と同様にクローン・インストール。
3. ClaudeのMCPサーバー設定を探す。
4. Markdownifyを追加:

   {
     "mcpServers": {
       "markdownify": {
         "command": "node",
         "args": [
           "/absolute/path/to/markdownify-mcp/dist/index.js"
         ],
         "env": {
           "UV_PATH": "/path/to/uv"
         }
       }
     }
   }
   

5. 保存してClaudeを再起動し、動作を確認。

Cursor

1. 必要: Node.js・pnpm。
2. クローン・依存関係インストール。
3. pnpm run buildでビルド。
4. CursorのmcpServers欄を編集:

   {
     "mcpServers": {
       "markdownify": {
         "command": "node",
         "args": [
           "/absolute/path/to/markdownify-mcp/dist/index.js"
         ],
         "env": {
           "UV_PATH": "/path/to/uv"
         }
       }
     }
   }
   

5. 保存しCursorを再起動。

Cline

1. Node.jsとpnpmをインストール後、上記同様にクローン・インストール。
2. プロジェクトをビルド。
3. mcpServers設定にMarkdownify MCPサーバーを追加:

   {
     "mcpServers": {
       "markdownify": {
         "command": "node",
         "args": [
           "/absolute/path/to/markdownify-mcp/dist/index.js"
         ],
         "env": {
           "UV_PATH": "/path/to/uv"
         }
       }
     }
   }
   

4. 保存しClineを再起動し、確認。

注意: APIキーの安全な管理には上記のように環境変数を活用してください。

フロー内でMCPを利用する方法

FlowHuntでのMCP利用

FlowHuntワークフローにMCPサーバーを統合するには、MCPコンポーネントをフローに追加し、AIエージェントと接続します。

MCPコンポーネントをクリックし、設定パネルを開きます。system MCP設定欄に以下のJSON形式でMCPサーバー情報を入力してください。

{
  "markdownify": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定が完了すると、AIエージェントがこのMCPの全機能をツールとして利用できるようになります。“markdownify"は実際のMCPサーバー名に、URLは自身のMCPサーバーのURLに置き換えてください。

概要

上記の表より、Markdownify MCPサーバーは実践的な変換ツールとセットアップガイドに特化していますが、プロンプトテンプレートやリソース、サンプリングやrootsなど高度なMCP機能に関する詳細は不足しています。ツールやセットアップに関しては明確ですが、より深いMCPプリミティブに関する情報はありません。

当社の見解

Markdownify MCPサーバーは、ドキュメントやコンテンツ変換用途として非常に実用的で、幅広いファイル形式への対応とセットアップ手順も充実しています。一方で、プロンプトテンプレートやMCPリソース、サンプリングやrootsなど高度な機能の明確な説明がないため、より高度なMCP連携ではスコアがやや下がります。実用的なファイル→Markdown変換用途には高評価、プロトコル拡張性の観点ではやや限定的です。

MCPスコア