MCP 服务器

TR Dizin Search MCP Server

Enables searching the TR Dizin (Turkish Academic Index) database for publications, journals, and authors with advanced filtering and sorting options.

README

TR Dizin MCP Server

TR Dizin veritabanında arama yapmak için geliştirilmiş MCP (Model Context Protocol) sunucusu.

Özellikler

Yayın Arama: TR Dizin'de makale ve yayın arama
Dergi Arama: TR Dizin'de dergi arama
Yazar Arama: TR Dizin'de yazar arama
Smithery Desteği: Smithery platformu üzerinden kolay kurulum ve kullanım

Smithery ile Kurulum (Önerilen)

Bu MCP server Smithery platformu üzerinden kolayca kullanılabilir:

Smithery hesabınıza giriş yapın
TR Dizin MCP Server'ı bulun ve yükleyin
Firecrawl API anahtarınızı yapılandırmaya ekleyin
Claude Desktop veya diğer MCP istemcilerinizde kullanmaya başlayın

Link: https://smithery.ai/server/%40Utku-Unluer%2Fsmithery-trdizin-search-mcp/tools

Firecrawl API Key Alma

Firecrawl.dev adresine gidin
Hesap oluşturun veya giriş yapın
API anahtarınızı alın (fc- ile başlar)
Bu anahtarı Smithery yapılandırmasında kullanın

Manuel Kurulum (Geliştirici)

Gereksinimler

Python 3.11+
Firecrawl API anahtarı

Kurulum Adımları

# 1. Repoyu klonlayın
git clone <repo-url>
cd trdizin-mcp

# 2. Sanal ortam oluşturun
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# veya
venv\Scripts\activate     # Windows

# 3. Bağımlılıkları yükleyin
pip install -r requirements.txt

# 4. Environment variable ayarlayın
export FIRECRAWL_API_KEY="your-api-key-here"

# 5. Server'ı çalıştırın
python server.py

Claude Desktop ile Manuel Kullanım

~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "trdizin": {
      "command": "python3",
      "args": ["/path/to/trdizin-mcp/server.py"],
      "env": {
        "FIRECRAWL_API_KEY": "your-api-key-here",
        "PYTHONPATH": "/path/to/trdizin-mcp"
      }
    }
  }
}

MCP Tools

search_trdizin_publications

TR Dizin'de yayın arar.

Parametreler:

query: Arama terimi (zorunlu)
order: Sıralama seçenekleri:
- publicationYear-DESC (varsayılan): Yayın yılına göre azalan
- publicationYear-ASC: Yayın yılına göre artan
- relevance-DESC: İlgiye göre azalan
- title-ASC: Başlığa göre artan
page: Sayfa numarası (varsayılan: 1)
limit: Sayfa başına sonuç sayısı (varsayılan: 20, maksimum: 100)

Örnek Kullanım:

TR Dizin'de "makine öğrenmesi" konusunda yayın ara

search_trdizin_journals

TR Dizin'de dergi arar.

Parametreler:

query: Arama terimi (zorunlu)
order: Sıralama seçenekleri:
- title-ASC (varsayılan): Başlığa göre artan
- title-DESC: Başlığa göre azalan
- relevance-DESC: İlgiye göre azalan
page: Sayfa numarası (varsayılan: 1)
limit: Sayfa başına sonuç sayısı (varsayılan: 20, maksimum: 100)

Örnek Kullanım:

TR Dizin'de "bilgisayar" içeren dergileri ara

search_trdizin_authors

TR Dizin'de yazar arar.

Parametreler:

query: Arama terimi (zorunlu)
order: Sıralama seçenekleri:
- relevance-DESC (varsayılan): İlgiye göre azalan
- name-ASC: İsme göre artan
- name-DESC: İsme göre azalan
page: Sayfa numarası (varsayılan: 1)
limit: Sayfa başına sonuç sayısı (varsayılan: 20, maksimum: 100)

Örnek Kullanım:

TR Dizin'de "Ahmet Özkan" yazarını ara

Docker ile Çalıştırma

# Docker image oluşturun
docker build -t trdizin-mcp .

# Container'ı çalıştırın
docker run -e FIRECRAWL_API_KEY="your-api-key" -it trdizin-mcp

Geliştirme

Test Etme

MCP Inspector kullanarak test edebilirsiniz:

# MCP Inspector'ı yükleyin
npm install -g @modelcontextprotocol/inspector

# Server'ı test edin
mcp-inspector python server.py

Hata Ayıklama

Verbose logging için:

export DEBUG=1
python server.py

Sorun Giderme

Yaygın Hatalar

"Firecrawl API key is required"
- Firecrawl API anahtarınızın doğru yapılandırıldığından emin olun
- API anahtarının geçerli olduğunu kontrol edin
"Module not found"
- Tüm bağımlılıkların yüklendiğinden emin olun: pip install -r requirements.txt
- Python path'ının doğru ayarlandığından emin olun
"Connection timeout"
- İnternet bağlantınızı kontrol edin
- TR Dizin sitesinin erişilebilir olduğunu kontrol edin