Ebook-MCP Sunucusu

“Ebook-MCP” MCP Sunucusu ne yapar?

Ebook-MCP, elektronik kitap işleme için tasarlanmış bir Model Context Protocol (MCP) sunucusudur ve EPUB ile PDF gibi yaygın formatları destekler. AI asistanları ile e-kitap içeriği arasında bir köprü görevi görerek, okuma ve öğrenme deneyimlerinin LLM tabanlı uygulama ve iş akışlarına sorunsuzca entegre edilmesini sağlar. Ebook-MCP, kullanıcıların dijital kütüphaneleriyle doğal dilde etkileşime geçmesine olanak tanıyarak kütüphane yönetimi, etkileşimli okuma ve içerik gezinme gibi işlemleri kolaylaştırır. Standartlaştırılmış API’ler sunarak, geliştiricilere e-kitaplardan doğrudan veritabanı benzeri sorgulamalar, diyalog tabanlı okuma ve aktif öğrenme desteği sağlayan araçlar geliştirme imkânı sunar; böylece dijital okuma materyalleriyle verimlilik ve kullanıcı deneyimini artırır.

Komut Listesi

Mevcut dokümantasyon veya kodda açıkça belirtilmiş bir komut şablonu bulunmamaktadır.

Kaynaklar Listesi

• EPUB dosya kaynağı – EPUB e-kitap dosyalarına erişim ve bu dosyaların analiz, özetleme ve sorgulama işlemleri için işlenmesini sağlar.
• PDF dosya kaynağı – PDF e-kitap dosyalarından içerik okuma ve çıkarımı yaparak bağlama duyarlı etkileşimler sunar.
• E-kitap meta verisi kaynağı – Kütüphanedeki kitaplar hakkında yazar, başlık ve bölüm ayrımı gibi yapılandırılmış bilgiler sağlar.
• Kütüphane klasörü kaynağı – E-kitap koleksiyonlarını veya dizinlerini temsil eder ve arama ile organizasyon işlemlerini mümkün kılar.

Araçlar Listesi

README veya mevcut dökümantasyonda açıkça belirtilmiş bir araç (fonksiyon veya MCP aracı olarak sunulan eylemler) listesi yoktur. Depoda dosya listeleme, içerik çıkarımı ve sorgulama için araçlar bulunması muhtemeldir; fakat mevcut materyallerde bunlar tek tek adlandırılmamıştır.

Bu MCP Sunucusunun Kullanım Senaryoları

• Akıllı Kütüphane Yönetimi: Kullanıcıların doğal dilde sorgularla (ör. “İndirilenler klasörümdeki tüm EPUB kitaplarını göster”) e-kitap koleksiyonlarını keşfetmesini, organize etmesini ve aramasını sağlar.
• Etkileşimli Okuma Deneyimi: Kitap içeriğiyle diyalog kurarak bölümlerin özetlenmesi, konuların açıklanması veya belirli bölümlerle ilgili soruların yanıtlanması gibi etkileşimler sunar.
• Aktif Öğrenme Desteği: E-kitap içeriğine dayalı quiz, açıklama ve pratik egzersizler oluşturarak daha ilgi çekici çalışma seansları sağlar.
• İçerik Gezinme: Kullanıcıların e-kitaplarda belirli konulara, bölümlere veya kavramlara diyalog tabanlı sorgularla ulaşmasını ve bu bölümlere atlamasını sağlar.
• Sorunsuz AI Entegrasyonu: E-kitap işleme yeteneklerini AI destekli IDE ve iş akışlarına bağlayarak dijital okuma materyallerini geliştirme ve araştırma görevleri için kolayca erişilebilir hale getirir.

Kurulum Nasıl Yapılır

Windsurf

1. Node.js ve Windsurf’ün kurulu olduğundan emin olun.
2. Windsurf’ün yapılandırma dosyasını bulun (örn. windsurf.config.json).
3. Ebook-MCP sunucusunu mcpServers bölümüne aşağıdaki örnek yapılandırma ile ekleyin:

   {
     "mcpServers": {
       "ebook-mcp": {
         "command": "ebook-mcp",
         "args": []
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve Windsurf’ü yeniden başlatın.
5. Windsurf arayüzünden Ebook-MCP sunucusunun çalışıp çalışmadığını kontrol edin.

API Anahtarlarını Güvence Altına Alma:

{
  "mcpServers": {
    "ebook-mcp": {
      "command": "ebook-mcp",
      "env": {
        "API_KEY": "${EBOOK_MCP_API_KEY}"
      },
      "inputs": {
        "apiKey": "${EBOOK_MCP_API_KEY}"
      }
    }
  }
}

${EBOOK_MCP_API_KEY} kısmını kendi anahtarınızla değiştirin ve güvenli bir şekilde saklayın.

Claude

1. Claude’un MCP entegrasyonunu desteklediğinden ve eklenti/yapılandırma arayüzüne erişiminiz olduğundan emin olun.
2. Dış sunucular için yapılandırma panelini açın.
3. Ebook-MCP’yi mcpServers nesnesine ekleyin.

   {
     "mcpServers": {
       "ebook-mcp": {
         "command": "ebook-mcp",
         "args": []
       }
     }
   }
   

4. Değişiklikleri kaydedin ve Claude’u yeniden başlatın.
5. Bağlantıyı Claude’un eklenti durumu veya logları üzerinden doğrulayın.

API Anahtarlarını Güvence Altına Alma:

{
  "mcpServers": {
    "ebook-mcp": {
      "command": "ebook-mcp",
      "env": {
        "API_KEY": "${EBOOK_MCP_API_KEY}"
      },
      "inputs": {
        "apiKey": "${EBOOK_MCP_API_KEY}"
      }
    }
  }
}

Cursor

1. Node.js’i yükleyin ve Cursor’un MCP eklenti entegrasyonunu desteklediğinden emin olun.
2. Cursor’un yapılandırma dosyasını düzenleyerek Ebook-MCP’yi ekleyin:

   {
     "mcpServers": {
       "ebook-mcp": {
         "command": "ebook-mcp",
         "args": []
       }
     }
   }
   

3. Kaydedin ve Cursor’u yeniden başlatın.
4. Uzantılar sekmesinde Ebook-MCP durumunu kontrol edin.

API Anahtarlarını Güvence Altına Alma:

{
  "mcpServers": {
    "ebook-mcp": {
      "command": "ebook-mcp",
      "env": {
        "API_KEY": "${EBOOK_MCP_API_KEY}"
      },
      "inputs": {
        "apiKey": "${EBOOK_MCP_API_KEY}"
      }
    }
  }
}

Cline

1. Cline’ın sisteminizde kurulu olduğundan emin olun.
2. Cline’ın yapılandırma dosyasını açın.
3. Aşağıda gösterildiği gibi Ebook-MCP sunucu bilgilerini ekleyin:

   {
     "mcpServers": {
       "ebook-mcp": {
         "command": "ebook-mcp",
         "args": []
       }
     }
   }
   

4. Kaydedin ve Cline’ı yeniden başlatın.
5. Cline’da Ebook-MCP’nin aktif MCP sunucusu olarak listelendiğini doğrulayın.

API Anahtarlarını Güvence Altına Alma:

{
  "mcpServers": {
    "ebook-mcp": {
      "command": "ebook-mcp",
      "env": {
        "API_KEY": "${EBOOK_MCP_API_KEY}"
      },
      "inputs": {
        "apiKey": "${EBOOK_MCP_API_KEY}"
      }
    }
  }
}

Hassas API anahtarlarını korumak için her zaman ortam değişkenlerini kullanın.

Bu MCP Nasıl Akışlarda Kullanılır

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, öncelikle MCP bileşenini akışınıza ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümüne, MCP sunucu bilgilerinizi şu JSON formatında girin:

{
  "ebook-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandığında, AI ajanınız bu MCP’yi tüm işlev ve yeteneklerine erişebileceği bir araç olarak kullanabilir. “ebook-mcp” ismini kendi MCP sunucunuzun adıyla ve URL’yi kendi MCP sunucu adresinizle değiştirmeniz gerektiğini unutmayın.

Genel Bakış

Mevcut dökümantasyon ve kod yapısına göre, Ebook-MCP güçlü kaynak ve kurulum dokümantasyonuna sahip, fakat açıkça belirtilmiş komut ve araç listeleri ile Roots veya Örnekleme desteği konusunda eksik. Entegrasyon ve pratik kullanım için iyi belgelenmiş, ancak daha fazla teknik ayrıntı tamamlayıcılığı artıracaktır.

MCP Puanı

Bizim görüşümüz:
Ebook-MCP, e-kitapları LLM’lerle entegre etmeye odaklanan, geliştirici ve AI destekli okuma iş akışlarıyla ilgilenenler için net değer sunan, iyi kurgulanmış bir MCP sunucusudur. Ancak, araçlar, komutlar, Roots ve Örnekleme gibi teknik dokümantasyon eksikliği nedeniyle şimdilik en uygun olduğu alan doğrudan e-kitap entegrasyonudur.

Ebook-MCP puanı: 6/10
Pratik kullanım için sağlam, fakat bazı teknik ayrıntılar ve gelişmiş MCP özelliklerinden yoksun.