🤖 AI Haber Bülteni MCP Sunucusu

Tavily API ve RSS kaynaklarından en güncel yapay zeka haberlerini çekerek tamamen Türkçe, kişiselleştirilmiş bültenler oluşturan MCP sunucusu.

✨ Özellikler

• 📰 6 farklı hedef kitle: C-Level, Ürün Yöneticisi, Geliştirici, VS Code + Copilot, Cursor, Windsurf
• 📅 3 farklı zaman dilimi: Günlük, Haftalık, Aylık
• 🔍 Tavily API ile gerçek zamanlı haber araması (güvenilir domain filtrelemesi dahil)
• 📡 27 güvenilir RSS kaynağı (TechCrunch, OpenAI, GitHub Copilot, Cursor, Windsurf vb.)
• ⚡ 30 dakikalık akıllı önbellekleme (cache)
• 🔄 Otomatik duplikasyon tespiti (URL + başlık benzerlik analizi)
• 🛡️ Hata toleranslı mimari (retry mekanizması, bir kaynak başarısız olursa diğerleri devam eder)
• 🎯 RSS haberleri zaman dilimine göre otomatik filtreleme
• 💰 Yapılandırılabilir Tavily arama derinliği (basic: 1 kredi, advanced: 2 kredi)
• 📝 MCP Prompts desteği (Claude Desktop'ta doğrudan seçilebilir)
• 🇹🇷 Tamamen Türkçe çıktı

📦 Kurulum

Ön Koşul: Tavily API Anahtarı

app.tavily.com adresinden ücretsiz API anahtarı alın.

Cursor ile Kullanım

~/.cursor/mcp.json dosyanıza ekleyin:

{
  "mcpServers": {
    "ai-haber-bulteni": {
      "command": "npx",
      "args": ["-y", "ai-haber-bulteni-mcp"],
      "env": {
        "TAVILY_API_KEY": "BURAYA_TAVILY_API_ANAHTARINIZI_YAZIN"
      }
    }
  }
}

VS Code + GitHub Copilot ile Kullanım

VS Code'da .vscode/mcp.json dosyası oluşturun (veya Command Palette > MCP: Add Server):

{
  "servers": {
    "ai-haber-bulteni": {
      "command": "npx",
      "args": ["-y", "ai-haber-bulteni-mcp"],
      "env": {
        "TAVILY_API_KEY": "BURAYA_TAVILY_API_ANAHTARINIZI_YAZIN"
      }
    }
  }
}

Not: VS Code'da MCP desteği için GitHub Copilot eklentisi (v1.100+) ve chat.mcp.enabled ayarının aktif olması gerekir. Ayarlar > chat.mcp.enabled > true yapın.

Windsurf ile Kullanım

~/.codeium/windsurf/mcp_config.json dosyanıza ekleyin:

{
  "mcpServers": {
    "ai-haber-bulteni": {
      "command": "npx",
      "args": ["-y", "ai-haber-bulteni-mcp"],
      "env": {
        "TAVILY_API_KEY": "BURAYA_TAVILY_API_ANAHTARINIZI_YAZIN"
      }
    }
  }
}

Claude Desktop ile Kullanım

claude_desktop_config.json dosyanıza ekleyin:

{
  "mcpServers": {
    "ai-haber-bulteni": {
      "command": "npx",
      "args": ["-y", "ai-haber-bulteni-mcp"],
      "env": {
        "TAVILY_API_KEY": "BURAYA_TAVILY_API_ANAHTARINIZI_YAZIN"
      }
    }
  }
}

🛠️ Araçlar (Tools)

| Tool | Açıklama | |------|----------| | fetch_ai_news | Ham AI haberlerini çeker (Tavily + RSS, cache destekli, tablo çıktı) | | generate_newsletter | Çekilen haberleri Türkçe bülten formatına dönüştürür | | save_newsletter | Bülteni .md + Outlook uyumlu .html olarak otomatik kaydeder | | list_newsletters | Daha önce kaydedilmiş bülten dosyalarını listeler | | get_newsletter_report | Tarama raporunu okur (hangi kaynaklar taranmış, hata alanlar vb.) | | export_newsletter_html | Mevcut .md bülteni farklı marka ayarlarıyla yeniden HTML'e dönüştürür | | get_available_sources | Aktif RSS kaynaklarını persona bazında listeler | | health_check | Tüm RSS kaynaklarının erişilebilirliğini test eder | | validate_links | Kaydedilmiş bültendeki URL'leri doğrular |

📁 Bülten Dosyaları Nereye Kaydedilir?

• Varsayılan: Açık projenizin/workspace'inizin kökünde newsletters/ klasörü oluşturulur. Cursor/VS Code MCP'yi workspace dizininde başlattığı için ek ayar gerekmez.
• Özel konum: NEWSLETTER_OUTPUT_DIR ortam değişkeni ile farklı bir dizin belirtebilirsiniz.

📊 Tarama Raporu

fetch_ai_news veya generate_newsletter her çalıştığında, newsletters/newsletter-tarama-raporu.md dosyası otomatik güncellenir. Raporda:

• Kaç kaynak tarandı (Tavily + RSS toplamı)
• Hangi haberler çekildi (ilk 15 örnek)
• Hangi RSS kaynakları hata aldı (404, timeout vb.)
• Tavily API durumu (başarılı/hata, benzersiz domain sayısı)
• Uyarılar (Tavily hatası, RSS yüklenemeyen kaynaklar)

Raporu okumak için get_newsletter_report aracını kullanabilirsiniz.

📝 Prompt

| Prompt | Açıklama | |--------|----------| | ai-bulten | Kişiselleştirilmiş Türkçe AI bülteni oluşturur (Claude Desktop'ta doğrudan seçilebilir) |

💬 Örnek Kullanım

Cursor, Windsurf veya Claude Desktop chat'inde:

"Geliştiriciler için bu haftaki yapay zeka bültenini oluştur"

"C-Level yöneticiler için aylık AI bülteni hazırla"

"Ürün yöneticileri için günlük AI haberlerini getir"

"VS Code + Copilot kullanıcıları için haftalık bülten oluştur"

"Cursor kullanıcıları için haftalık AI bültenini hazırla"

"Windsurf kullanıcıları için bu haftanın bültenini oluştur"

"Hangi haber kaynakları kullanılıyor?"

"Bu bülteni kaydet"

"Kayıtlı bültenleri listele"

"Developer bültenini HTML e-posta olarak dışa aktar"

"C-Level bültenini şirket logomuz ve marka rengimizle HTML e-postaya dönüştür"

🔑 Parametreler

| Parametre | Değerler | Varsayılan | Açıklama | |-----------|----------|------------|----------| | persona | c_level, product_manager, developer, copilot_user, cursor_user, windsurf_user | developer | Hedef kitle | | timeframe | daily, weekly, monthly | weekly | Zaman dilimi | | maxItems | 5 - 25 | 15 | Tavily toplam / RSS kaynak başına max haber | | searchDepth | basic, advanced | advanced | Tavily arama derinliği (advanced = 2x kredi, daha detaylı özet) |

📡 RSS Kaynakları (27 kaynak)

C-Level & Strateji:

• TechCrunch AI — C-Level, PM
• VentureBeat AI — C-Level
• MIT Technology Review — C-Level, Developer
• AI Business — C-Level
• NVIDIA AI Blog — C-Level, Developer
• Microsoft AI Blog — C-Level, PM
• Wired AI — C-Level, PM

Ürün & Platform:

• OpenAI News — PM, Developer, Cursor, Windsurf
• Anthropic News — PM, Developer, Cursor, Windsurf
• Google AI Blog — PM, C-Level, Cursor, Windsurf
• The Verge AI — PM
• AWS Machine Learning — PM, Developer, C-Level

Developer & Araştırma:

• HuggingFace Blog — Developer
• Simon Willison's Blog — Developer, Cursor, Windsurf
• MarkTechPost — Developer
• Ars Technica — Developer
• Towards Data Science — Developer
• Latent Space — Developer, Cursor, Windsurf

AI Kodlama Araçları:

• GitHub Blog — Developer, PM, Copilot, Cursor, Windsurf
• GitHub Copilot Changelog — Developer, Copilot
• VS Code Blog — Developer, Copilot
• Cursor Announcements — Developer, Cursor
• Windsurf (Codeium) Blog — Developer, Windsurf

VS Code + Copilot Ekosistemi:

• GitHub Changelog — Copilot User
• VS Code DevBlogs — Copilot User
• Ken Muse Blog — Copilot User
• GitHub AI/ML Blog — Copilot User

🏗️ Geliştirme

# Klonla
git clone https://github.com/erhankaraarslan/ai-haber-bulteni-mcp.git
cd ai-haber-bulteni-mcp

# Bağımlılıkları kur
npm install

# .env dosyasını oluştur
cp .env.example .env
# .env dosyasına TAVILY_API_KEY değerini yaz

# Geliştirme modunda çalıştır
npm run dev

# Build al
npm run build

# Testleri çalıştır
npm test

🗺️ Yol Haritası (Roadmap)

• [ ] Önem puanlama (kaynak güvenilirliği ve etkileşim verilerine göre sıralama)
• [ ] Kullanıcının özel RSS kaynağı ekleyebilmesi (parametre olarak)
• [x] Outlook uyumlu HTML e-posta şablonuna dönüştürme (export_newsletter_html)
• [ ] Çıktı formatı seçimi (Markdown, HTML, Plain Text)
• [ ] Türkçe haber kaynakları desteği
• [ ] E-posta ile otomatik bülten gönderimi

📄 Lisans

MIT