LiteratüR

БесплатноНе проверен

Enables searching, PDF conversion, and reference extraction for Turkish academic articles on DergiPark via MCP tools.

автор: saidsurucu

GitHub Embed

Описание

Enables searching, PDF conversion, and reference extraction for Turkish academic articles on DergiPark via MCP tools.

README

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

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

Google Antigravity ile Kullanım

Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın
MCP Servers seçeneğini seçin - MCP Store açılacak
Üstteki Manage MCP Servers butonuna tıklayın
View raw config seçeneğine tıklayın
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

🚀 Claude Haricindeki Modellerle Kullanmak İçin Kurulum (Örnek: 5ire için)

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.

⚙️ Claude Desktop Manuel Kurulumu

Ön Gereksinimler: Python ve uv'nin sisteminizde kurulu olduğundan emin olun.
Claude Desktop Settings -> Developer -> Edit Config.

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"
      }
    }
  }
}

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

🛠️ Kullanılabilir Araçlar (MCP Tools)

Bu FastMCP sunucusu 3 MCP aracı sunar:

search_articles

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

Parametre	Tip	Varsayılan	Açıklama
`query`	string	`""`	Arama sorgusu (ör: "yapay zeka")
`page`	int	`1`	Sayfa numarası (sayfa başına 24 makale)
`sort`	string	`null`	Sıralama: `newest` veya `oldest`
`article_type`	string	`null`	Makale türü (ör: `54` = Araştırma Makalesi)
`year`	string	`null`	Yayın yılı filtresi (ör: `2024`)
`index_filter`	string	`hepsi`	Dizin filtresi: `tr_dizin_icerenler`, `bos_olmayanlar`, `hepsi`

Ö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.

Parametre	Tip	Açıklama
`pdf_id`	string	DergiPark makale dosya ID'si (ör: `118146`)

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

PDF İşleme Akışı:

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

get_article_references

Makale referans listesini çeker.

Parametre	Tip	Açıklama
`article_url`	string	DergiPark makale URL'i

🐳 Docker ile Çalıştırma

# 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

Değişken	Zorunlu	Açıklama
`CAPSOLVER_API_KEY`	Evet	CAPTCHA çözümü için CapSolver API anahtarı
`MISTRAL_API_KEY`	Hayır	Taranmış PDF'ler için Mistral OCR API anahtarı
`HEADLESS_MODE`	Hayır	Tarayıcı modu: `true` veya `false` (varsayılan)

📄 Lisans

MIT

from github.com/saidsurucu/literatur-mcp

Установка LiteratüR

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/saidsurucu/literatur-mcp

FAQ

LiteratüR MCP бесплатный?

Да, LiteratüR MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для LiteratüR?

Нет, LiteratüR работает без API-ключей и переменных окружения.

LiteratüR — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить LiteratüR в Claude Desktop, Claude Code или Cursor?

Открой LiteratüR на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Compare LiteratüR with

LiteratüRvsGitHub LiteratüRvsFilesystem LiteratüRvsMemory LiteratüRvsTemplate MCP Server

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development

Command Palette