emko-mcp

Emko Elektronik (emkoelektronik.com.tr) ürün manuellerini arayıp okuyan MCP sunucusu.

Özellikler (1.0.0)

• 3 tool: emko_search_manuals (ara), emko_get_manual (indir + metin/tablo çıkar), emko_crawl_category (kategori tara ve indeksle)
• Tablo çıkarımı: Register tabloları [Sayfa N tabloları] başlıklarıyla markdown olarak verilir (pdfplumber)
• Akıllı dosya seçimi: .pdf adlı dosyalar öncelikli; indirilen içerik PDF değilse (config/DATA.TXT) sıradaki aday otomatik denenir
• Türkçe duyarsız arama: "Universal" araması "Üniversal"i de bulur
• Çoklu indeks arama: Yükleme Merkezi + oturumdaki tüm kategori taramalarında birden arar

YouTube (1.1.0)

• emko_list_videos — EMKO YouTube kanalındaki videoları listeler (başlık filtresi desteklenir)
• emko_video_transcript — bir videonun transkriptini zaman damgalı bloklar halinde getirir (TR/EN, otomatik altyazı dahil)

Büyük belgelerde sayfalama (1.2.0)

Çok büyük kılavuzlar (ör. IDE kılavuzu, ~800 bin karakter) tek yanıta sığmaz. emko_get_manual böyle bir belgede ilk parçayı verir ve sonuna "devamı için start_char=N" bilgisi ekler. Aynı sorguyu o start_char ile tekrar çağırarak sonraki parçayı alırsınız. Küçük belgelerde bu gerekmez; davranış öncekiyle aynıdır (start_char varsayılanı 0).

Tam video listesi (1.3.0)

emko_list_videos artık kanalın tüm videolarını listeler (önceki sürümlerde yalnızca en son ~15 video gelebiliyordu). Liste öncelikle yt-dlp ile çekilir ve oturum boyunca önbelleğe alınır; böylece yt-dlp yalnızca bir kez çalışır, sonraki çağrılar anında yanıtlanır. yt-dlp pip install ile otomatik gelir, ayrıca bir kurulum gerektirmez. Herhangi bir nedenle yt-dlp kullanılamazsa daha sınırlı yedeklere (kanal sayfası, ardından son ~15 videoyu veren RSS) düşülür ve bu durumda listenin eksik olabileceği yanıtta belirtilir.

Otomatik kurulum (1.5.0)

pip install emko-mcp sonrası tek komutla config'e ekleyin:

emko-mcp-setup

Bu komut, makinede kurulu olan tüm desteklenen hedeflere emko'yu ekler: Claude Desktop (config dosyasını doğrudan düzenler), Codex (codex mcp add) ve VS Code / Claude Code (claude mcp add). Kurulu olmayan hedefler atlanır.

• Config yoksa oluşturulur; varsa mevcut sunucular bozulmadan korunur.
• emko zaten ekliyse yalnızca yolu güncellenir (çift kayıt olmaz).
• Her değişiklikten önce .bak yedeği alınır.

Seçenekler:

emko-mcp-setup --dry-run          # hiçbir şeye dokunma, ne yapılacağını göster
emko-mcp-setup --only claude      # yalnızca Claude Desktop
emko-mcp-setup --only codex       # yalnızca Codex
emko-mcp-setup --only vscode      # yalnızca VS Code (Claude Code)
emko-mcp-setup --command <yol>    # emko-mcp yolu otomatik bulunamazsa elle ver

Kurulumdan sonra ilgili uygulamayı (Claude Desktop / VS Code) yeniden başlatın.

Okunabilir kopya seçimi (1.4.0)

Emko sitesinde aynı kılavuz bazen iki kopya halinde bulunur: biri gerçek metin katmanlı, diğeri görüntü-tabanlı (metin çıkmaz). emko_get_manual artık bir kopyadan metin çıkaramazsa (görüntü-tabanlı çıkarsa) otomatik olarak sıradaki kopyayı dener; böylece hangi kaynaktan (ürün sayfası ya da Yükleme Merkezi) çekilirse çekilsin okunabilir sürüm bulunur. Yalnızca görüntü-tabanlı kopya varsa, durum yanıtta belirtilir.

Kurulum

pip install emko-mcp

Claude Desktop config

{
  "mcpServers": {
    "emko": { "command": "emko-mcp" }
  }
}

emko-mcp komutu PATH'te değilse tam yol kullanın (pip kurulum çıktısındaki Scripts klasörü):

"emko": { "command": "C:\\...\\Scripts\\emko-mcp.exe" }

Kullanım örnekleri

• "EtherCAT gateway kılavuzunu getir"
• "I/O genişleme modülleri kategorisini tara" → sonra "SMR1P1 modülünün register tablosunu göster"