Skip to content

A Model Context Protocol server for converting almost anything to Markdown

License

Notifications You must be signed in to change notification settings

pashpashpash/markdownify-mcp

 
 

Repository files navigation

Markdownify MCP Server

Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.

Markdownify Server MCP server

Features

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

Installation

  1. Clone the Repository:

    git clone https://github.com/pashpashpash/markdownify-mcp.git
    cd markdownify-mcp
  2. Install Dependencies:

    pnpm install

    Note: This will also install uv and related Python dependencies.

  3. Build the Project:

    pnpm run build

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": ["path/to/markdownify-mcp/dist/index.js"],
      "env": {
        "UV_PATH": "/path/to/uv"
      }
    }
  }
}

Note: Replace "path/to/markdownify-mcp" with the actual path to your cloned repository.

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 pages to Markdown
  • image-to-markdown: Convert images to Markdown with metadata
  • audio-to-markdown: Convert audio files to Markdown with transcription
  • 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 an existing Markdown file

Development

# Start TypeScript compiler in watch mode
pnpm run dev

# Build the project
pnpm run build

Server Customization

  • Modify src/server.ts to customize server behavior
  • Add or modify tools in src/tools.ts

Debugging

If you run into issues, check Claude Desktop's MCP logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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


Note: This is a fork of the original markdownify-mcp repository.

About

A Model Context Protocol server for converting almost anything to Markdown

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 94.5%
  • JavaScript 3.5%
  • Shell 2.0%