Literatür MCP: Türk Akademik Dergileri için MCP Sunucusu

Word'den UDF'ye profesyonel dönüşüm için yeni uygulamam udfcevir.com adresinde!

Bu proje, DergiPark üzerinden Türk akademik dergi makalelerine erişimi kolaylaştıran bir FastMCP sunucusu oluşturur. Bu sayede, makale arama, PDF dönüştürme ve referans çekme işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya 5ire) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

🔗 Remote MCP Adresi: https://literatur-mcp.surucu.dev/mcp

Claude Desktop ile Kullanım

1. Claude Desktop'ı açın
2. Settings → Connectors → Add Custom Connector
3. Bilgileri girin:
   • Name: Literatür MCP
   • URL: https://literatur-mcp.surucu.dev/mcp
4. Add butonuna tıklayın
5. Hemen kullanmaya başlayın! 🎉

Google Antigravity ile Kullanım

1. Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın
2. MCP Servers seçeneğini seçin - MCP Store açılacak
3. Üstteki Manage MCP Servers butonuna tıklayın
4. View raw config seçeneğine tıklayın
5. mcp_config.json dosyasına aşağıdaki yapılandırmayı ekleyin:

{
  "mcpServers": {
    "literatur-mcp": {
      "serverUrl": "https://literatur-mcp.surucu.dev/mcp/",
      "headers": {
        "Content-Type": "application/json"
      }
    }
  }
}

💡 İpucu: Remote MCP sayesinde Python, uv veya herhangi bir kurulum yapmadan doğrudan Claude Desktop üzerinden DergiPark akademik makalelerine erişebilirsiniz!

🎯 Temel Özellikler

• Makale Arama: Yıl, tür, dizin ve sıralama filtrelerine göre akademik makaleleri arayın
• PDF'den HTML'e: Akademik PDF'leri okunabilir HTML formatına dönüştürün
• Akıllı OCR: Taranmış PDF'ler için otomatik Mistral OCR fallback
• CAPTCHA Çözme: CapSolver API ile otomatik Turnstile/reCAPTCHA çözümü
• Cookie Kalıcılığı: Cookie'ler disk ve belleğe kaydedilir, CAPTCHA tekrarını önler
• Paralel İşleme: 3 eşzamanlı HTTP isteği ile hızlı makale çekme
• Referans Çekme: Makale referans listelerini otomatik olarak çekin
• Önbellekleme: Cookie (30dk), link (10dk) ve PDF (24s) için bellek içi önbellek

Bu bölüm, DergiPark MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.

• Python Kurulumu: Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "Add Python to PATH" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. Buradan indirebilirsiniz.
• uv Kurulumu:
  • Windows Kullanıcıları (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Mac/Linux Kullanıcıları (Terminal): curl -LsSf https://astral.sh/uv/install.sh | sh
• İşletim sisteminize uygun 5ire MCP istemcisini indirip kurun.
• 5ire'ı açın. Workspace -> Providers menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
• Tools menüsüne girin. +Local veya New yazan butona basın.
  • Tool Key: literatur-mcp
  • Name: Literatür MCP
  • Command:

    uvx --from git+https://github.com/saidsurucu/literatur-mcp literatur-mcp
    

  • Environment Variables:

    CAPSOLVER_API_KEY=your_capsolver_key
    MISTRAL_API_KEY=your_mistral_key
    

  • Save butonuna basarak kaydedin.

1. Ön Gereksinimler: Python ve uv'nin sisteminizde kurulu olduğundan emin olun.

2. Claude Desktop Settings -> Developer -> Edit Config.

3. Açılan claude_desktop_config.json dosyasına mcpServers altına ekleyin:

   {
     "mcpServers": {
       "Literatür MCP": {
         "command": "uv",
         "args": ["run", "python", "mcp_server.py"],
         "cwd": "/path/to/literatur-mcp/dergipark-api",
         "env": {
           "CAPSOLVER_API_KEY": "your_capsolver_key",
           "MISTRAL_API_KEY": "your_mistral_key"
         }
       }
     }
   }
   

4. Claude Desktop'ı kapatıp yeniden başlatın.

Bu FastMCP sunucusu 3 MCP aracı sunar:

search_articles

DergiPark'ta akademik makale arar. Sayfa başına 24 makale döndürür.

Örnek Yanıt:

{
  "pagination": {"page": 1, "per_page": 24, "count": 24},
  "articles": [
    {
      "title": "Makale Başlığı",
      "url": "https://dergipark.org.tr/tr/pub/dergi/article/123456",
      "details": {
        "citation_author": "Yazar Adı",
        "citation_journal_title": "Dergi Adı",
        "citation_publication_date": "2024",
        "citation_abstract": "Makale özeti...",
        "citation_keywords": "anahtar1, anahtar2",
        "citation_doi": "10.1234/ornek"
      },
      "indices": "TR Dizin, DOAJ",
      "pdf_url": "https://dergipark.org.tr/tr/download/article-file/123456"
    }
  ]
}

pdf_to_html

DergiPark PDF'ini okunabilir HTML formatına dönüştürür.

URL otomatik oluşturulur: https://dergipark.org.tr/tr/download/article-file/{pdf_id}

PDF İşleme Akışı:

1. PDF'i DergiPark'tan indir
2. PyMuPDF ile metin çıkar
3. Metin < 100 karakter ise (taranmış PDF) Mistral OCR kullan
4. Formatlanmış HTML döndür

get_article_references

Makale referans listesini çeker.

# Build
docker build -t dergipark-mcp .

# Run
docker run -p 8000:8000 \
  -e CAPSOLVER_API_KEY=your_key \
  -e HEADLESS_MODE=false \
  dergipark-mcp

📋 Ortam Değişkenleri

📄 Lisans

MIT