Markdownify MCP

🚀 Markdownify MCP Server

Markdownify is a Model Context Protocol (MCP) server that can convert various file types and web content into Markdown format. It offers a set of tools to transform content from PDF, images, audio files, web pages, etc., into easily readable and shareable Markdown text.

✨ Features

• Convert multiple file types to Markdown:
  • PDF
  • Images
  • Audio with transcription
  • DOCX
  • XLSX
  • PPTX
• Convert web content to Markdown:
  • YouTube video subtitles
  • Bing search results
  • General web pages
• Retrieve existing Markdown files

🚀 Quick Start

1. Clone this repository.
2. Install dependencies:

   pnpm install
   

   ⚠️ Important Note

   This will also install uv and related Python dependencies.

3. Build the project:

   pnpm run build
   

4. Start the server:

   pnpm start
   

🔧 Development

• Use pnpm run dev to start the TypeScript compiler in watch mode.
• Modify src/server.ts to customize server behavior.
• Add or modify tools in src/tools.ts.

💻 Usage Examples

Integrating with Desktop Applications

To integrate this server with a desktop application, add the following to the application's server configuration:

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ],
      "env": {
        // By default, the server will use the default installation location of `uv`
        "UV_PATH": "/path/to/uv"
      }
    }
  }
}

Available Tools

• youtube-to-markdown: Convert YouTube videos to Markdown.
• pdf-to-markdown: Convert PDF files to Markdown.
• bing-search-to-markdown: Convert Bing search results to Markdown.
• webpage-to-markdown: Convert web page content to Markdown.
• image-to-markdown: Convert images to Markdown with metadata.
• audio-to-markdown: Convert audio files to Markdown with transcribed text.
• docx-to-markdown: Convert DOCX files to Markdown.
• xlsx-to-markdown: Convert XLSX files to Markdown.
• pptx-to-markdown: Convert PPTX files to Markdown.
• get-markdown-file: Retrieve existing Markdown files.

🤝 Contribution

Contributions are welcome! Feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.