Markdownify MCP Server

Markdownify, çeşitli dosya türlerini ve web içeriğini Markdown formatına dönüştüren bir Model Context Protocol (MCP) sunucusudur. PDF'leri, görselleri, ses dosyalarını, web sayfalarını ve daha fazlasını kolayca okunabilir ve paylaşılabilir Markdown metne dönüştürmek için bir araç seti sağlar.

Özellikler

• Birden fazla dosya türünü Markdown'a dönüştürün:
  • PDF
  • Görseller
  • Ses (transkripsiyon ile)
  • DOCX
  • XLSX
  • PPTX
• Web içeriğini Markdown'a dönüştürün:
  • YouTube video transkriptleri
  • Bing arama sonuçları
  • Genel web sayfaları
• Mevcut Markdown dosyalarını alın

Başlangıç

1. Bu depoyu klonlayın

2. Bağımlılıkları kurun:

   bun install
   

   preinstall adımı .venv konumunda bir Python sanal ortamı oluşturur ve markitdown[all] yükler.

3. Projeyi derleyin:

   bun run build
   

4. Sunucuyu başlatın:

   bun start
   

Geliştirme

• TypeScript derleyicisini izleme modunda başlatmak için bun run dev kullanın
• Sunucu davranışını özelleştirmek için src/server.ts dosyasını değiştirin
• src/tools.ts dosyasında araçları ekleyin veya değiştirin

Desktop Uygulaması ile Kullanım

Bu sunucuyu bir desktop uygulaması ile entegre etmek için, uygulamanızın sunucu yapılandırmasına aşağıdakini ekleyin:

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

Ortam değişkenleri

Tüm yollar makul varsayılanlara ayarlanmıştır; varsayılanlar kurulum düzeninize uygun değilse yalnızca geçersiz kılın.

Değişken	Varsayılan	Amaç
MARKITDOWN_PATH	<project>/.venv/bin/markitdown, ardından PATH üzerinde markitdown	markitdown çalıştırılabiliri için mutlak yol. Bundled venv yerine markitdown'ı sistem genelinde kurduğunuzda bunu ayarlayın (örneğin pipx install "markitdown[pdf]").
REPOMIX_PATH	<project>/node_modules/.bin/repomix, ardından PATH üzerinde repomix	git-repo-to-markdown tarafından kullanılan repomix çalıştırılabiliri için mutlak yol.
MD_ALLOWED_PATHS	ayarlanmamış (sınırsız)	Sunucunun okumaya izin verilen dizinlerin yol-sınırlayıcı ayrılmış listesi (POSIX'te :, Windows'ta ;). Ayarlandığında, tüm dosya-giriş araçları (pdf-to-markdown, get-markdown-file, vb.) bu dizinlerin dışındaki yolları reddeder.
MD_SHARE_DIR	ayarlanmamış	MD_ALLOWED_PATHS için kullanımdan kaldırılan takma ad (tek dizin). Geriye dönük uyumluluk için hala onurlandırılır.

Docker ile Kullanım

Derleyin ve çalıştırın:

docker build -t markdownify-mcp .
docker run --rm -i \
  -v "$HOME/Documents:/data:ro" \
  -e MD_ALLOWED_PATHS=/data \
  markdownify-mcp

Docker MCP kataloğu (mcp/markdownify) için notlar:

• Sunucunun okumasını istediğiniz ana bilgisayar dizinlerini konteynere takın, ardından konteyner yollarını araçlara geçirin (örneğin /data/foo.pdf, /Users/you/Documents/foo.pdf değil).
• MD_ALLOWED_PATHS öğesini takılı dizinlerin iki nokta üstü üste ayrılmış listesine ayarlayın, böylece sunucu bind mount ile eşleşen bir okuma sınırı uygular.
• Yayınlanan Docker imajı yalnızca markitdown[pdf] yükler — ses transkripsiyon ve görsel OCR (audio-to-markdown, image-to-markdown) [all] ekstralarını gerektirir ve slim imajda başarısız olur. Tam özellik seti için yerel yüklemeyi (bun install) kullanın.

Kullanılabilir Araçlar

• youtube-to-markdown: YouTube videolarını Markdown'a dönüştürün

• pdf-to-markdown: PDF dosyalarını Markdown'a dönüştürün

• bing-search-to-markdown: Bing arama sonuçlarını Markdown'a dönüştürün

• webpage-to-markdown: Web sayfalarını Markdown'a dönüştürün

• image-to-markdown: Görselleri Markdown'a meta verilerle dönüştürün

• audio-to-markdown: Ses dosyalarını Markdown'a transkripsiyon ile dönüştürün

• docx-to-markdown: DOCX dosyalarını Markdown'a dönüştürün

• xlsx-to-markdown: XLSX dosyalarını Markdown'a dönüştürün

• pptx-to-markdown: PPTX dosyalarını Markdown'a dönüştürün

• get-markdown-file: Mevcut bir Markdown dosyasını alın. Dosya uzantısı şu şekilde bitmelidir: *.md, *.markdown.

  İSTEĞE BAĞLI: Her dosya-giriş aracını bir dizin listesine sınırlamak için MD_ALLOWED_PATHS öğesini ayarlayın, örneğin MD_ALLOWED_PATHS=/data/in:/data/out bun start.

Katkıda Bulunma

Katkılar memnuniyetle karşılanır! Lütfen bir Pull Request göndermeyi çekinmeyin.

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır - ayrıntılar için LICENSE dosyasına bakın.