Ana Sayfaya Dön

MCP Kaynaklar ve Araçlar

Model Context Protocol (MCP) ekosistemi için faydalı kaynaklar, araçlar ve sunucu örnekleri.

📚 Resmi Dokümantasyon

Model Context Protocol

GitHub Organizasyonu

🔧 Geliştirme Araçları

MCP Inspector

URL: https://inspector.use-mcp.dev

MCP sunucularını test etmek ve debug etmek için web tabanlı araç.

Özellikler:

  • 🔍 Sunucu keşfi (tools, resources, prompts)
  • 🧪 Tool'ları test etme
  • 📡 JSON-RPC mesajlarını görüntüleme
  • 🐛 Hata ayıklama

Kullanım:

# STDIO sunucu testi
mcp dev server.py

# HTTP sunucu testi
# Inspector'da http://localhost:8000 adresine bağlan

MCP CLI

FastMCP ile gelen komut satırı arayüzü:

# Sunucu çalıştırma
mcp dev server.py

# Sunucu test etme
mcp run server.py

# Loglama ile çalıştırma
mcp dev server.py --log-level DEBUG

⚡ FastMCP

Nedir?

FastMCP, Model Context Protocol için hızlı ve kolay Python framework'üdür. MCP sunucuları oluşturmayı kolaylaştırır.

Resmi Kaynaklar

Kurulum

# pip ile kurulum
pip install fastmcp

# veya uv ile
uv add fastmcp

Hızlı Başlangıç

from fastmcp import FastMCP

# Sunucu oluştur
mcp = FastMCP("Merhaba Dünya")

@mcp.tool()
def merhaba(isim: str) -> str:
    """Kullanıcıya merhaba der."""
    return f"Merhaba, {isim}!"

@mcp.resource("config://ayarlar")
def get_config() -> str:
    """Yapılandırma bilgilerini döndürür."""
    return "Uygulama ayarları..."

# Sunucuyu başlat
if __name__ == "__main__":
    mcp.run()

Temel Özellikler

  • 🚀 Hızlı Geliştirme: Dekoratörler ile kolay tool/resource tanımlama
  • 📝 Otomatik Şema: Type hints'ten JSON Schema oluşturma
  • 🔍 MCP Inspector Desteği: mcp dev komutu ile test
  • 🌐 Transport Desteği: stdio ve HTTP (SSE)
  • 📚 Kapsamlı Dokümantasyon: Detaylı rehberler ve örnekler

Örnek Projeler

# Örnek sunucuları klonla
git clone https://github.com/jlowin/fastmcp
cd fastmcp/examples

# Örnek çalıştır
mcp dev weather_server.py

MCP ile Karşılaştırma

| Özellik | MCP SDK | FastMCP | |---------|---------|---------| | Kurulum | Manual | Otomatik | | Tool Tanımlama | Sınıf tabanlı | Dekoratör tabanlı | | Şema | Manual JSON | Type hints'ten | | Öğrenme Eğrisi | Yüksek | Düşük |

📦 MCP Sunucu Koleksiyonları

1. Resmi MCP Sunucuları

GitHub: https://github.com/modelcontextprotocol/servers

Anthropic tarafından geliştirilen resmi sunucu örnekleri.

İçerik:

  • 🗄️ Filesystem: Dosya sistemi operasyonları
  • 🌐 Fetch: Web içeriği getirme
  • 🔍 Google Drive: Google Drive entegrasyonu
  • 💾 Git: Git repository yönetimi
  • 🐘 PostgreSQL: Veritabanı erişimi
  • 📦 Slack: Slack entegrasyonu
  • 🔐 Brave Search: Web arama
  • 📝 Google Maps: Konum servisleri

Kurulum:

# NPM ile
npx -y @modelcontextprotocol/server-<name>

# Python ile
pip install mcp-server-<name>

2. Awesome MCP Servers (wong2)

GitHub: https://github.com/wong2/awesome-mcp-servers

Topluluk tarafından oluşturulan kapsamlı MCP sunucu listesi.

Kategoriler:

  • 🤖 AI & ML Entegrasyonları
  • 📊 Veri ve Analitik
  • 💬 İletişim Araçları
  • 🛠️ Geliştirici Araçları
  • 🎨 Yaratıcı Araçlar
  • 🏢 İşletme Uygulamaları

Popüler Sunucular:

  • mcp-server-time: Tarih ve saat işlemleri
  • mcp-server-weather: Hava durumu servisi
  • mcp-server-youtube: YouTube entegrasyonu
  • mcp-server-docker: Docker konteyner yönetimi
  • mcp-server-redis: Redis veritabanı

3. Awesome MCP Servers (punkpeye)

GitHub: https://github.com/punkpeye/awesome-mcp-servers

Alternatif kapsamlı MCP sunucu koleksiyonu.

Ek Kaynaklar:

  • 📖 Kullanım örnekleri
  • 🎓 Tutorial'lar
  • 🔗 İlgili araçlar
  • 🌟 Öne çıkan projeler

4. Docker Hub - MCP Sunucuları

URL: https://hub.docker.com/mcp

Docker container olarak hazır MCP sunucuları.

Avantajlar:

  • ✅ Anında kullanıma hazır
  • 🐳 Docker ile kolay deployment
  • 🔄 Versiyon kontrolü
  • 📦 Dependency yönetimi

Kullanım:

# Docker ile çalıştırma
docker pull mcp/<sunucu-adi>
docker run -p 8000:8000 mcp/<sunucu-adi>

🎯 Popüler Kullanım Senaryoları

1. Dosya İşlemleri

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("file-manager")

@mcp.tool()
def dosya_oku(yol: str) -> str:
    """Dosya içeriğini okur."""
    with open(yol, 'r', encoding='utf-8') as f:
        return f.read()

@mcp.tool()
def dosya_yaz(yol: str, icerik: str) -> str:
    """Dosyaya içerik yazar."""
    with open(yol, 'w', encoding='utf-8') as f:
        f.write(icerik)
    return f"{yol} dosyasına yazıldı."

2. API Entegrasyonu

import requests

@mcp.tool()
def hava_durumu_getir(sehir: str) -> dict:
    """Şehir için hava durumunu getirir."""
    api_key = "YOUR_API_KEY"
    url = f"https://api.openweathermap.org/data/2.5/weather"
    params = {"q": sehir, "appid": api_key, "lang": "tr", "units": "metric"}
    
    response = requests.get(url, params=params)
    data = response.json()
    
    return {
        "sehir": sehir,
        "sicaklik": data["main"]["temp"],
        "durum": data["weather"][0]["description"]
    }

3. Veritabanı İşlemleri

import sqlite3

@mcp.tool()
def veritabani_sorgula(sorgu: str) -> list:
    """SQL sorgusu çalıştırır."""
    conn = sqlite3.connect('veritabani.db')
    cursor = conn.cursor()
    cursor.execute(sorgu)
    sonuclar = cursor.fetchall()
    conn.close()
    return sonuclar

🌟 Öne Çıkan Projeler

Community Spotlight

1. MCP Server for GitHub

Kapsamlı GitHub entegrasyonu.

Özellikler:

  • Repository yönetimi
  • Issue tracking
  • Pull request oluşturma
  • Code search

2. MCP Server for Notion

Notion workspace entegrasyonu.

Özellikler:

  • Sayfa oluşturma/düzenleme
  • Veritabanı sorguları
  • İçerik arama

3. MCP Server for Airtable

Airtable veritabanı yönetimi.

Özellikler:

  • Kayıt ekleme/güncelleme
  • Tablo sorguları
  • Bağlantılı kayıt yönetimi

📖 Öğrenme Kaynakları

Makaleler ve Blog Yazıları

  1. "Building Your First MCP Server"

    • Adım adım başlangıç kılavuzu
    • Pratik örnekler

  2. "MCP Best Practices"

    • Performans optimizasyonu
    • Güvenlik ipuçları
    • Hata yönetimi

  3. "Advanced MCP Patterns"

    • Karmaşık entegrasyonlar
    • Çoklu sunucu mimarisi
    • Ölçeklendirme stratejileri

Video İçerikleri

  • 🎥 MCP Tanıtım Videoları: Temel konseptler
  • 🎬 Tutorial Serisi: Pratik uygulamalar
  • 🎓 Workshop Kayıtları: Detaylı projeler

🇹🇷 Türkçe Video İçerikler

🇹🇷 Yerli MCP Sunucuları

Türk geliştiriciler ve şirketler tarafından oluşturulan MCP sunucuları ve kaynakları.

Turkish Airlines MCP

Blog Yazısı: Revolutionizing Travel AI: How We Built Turkish Airlines MCP

Türk Hava Yolları'nın yapay zeka asistanları için geliştirdiği MCP sunucusu. Uçuş bilgileri, rezervasyon yönetimi ve müşteri desteği entegrasyonu sağlar.

Özellikler:

  • ✈️ Uçuş arama ve bilgi sorgulama
  • 🎫 Rezervasyon yönetimi
  • 💬 Müşteri desteği entegrasyonu
  • 🌍 Çok dilli destek

Arena MCP

URL: https://mcp.arena.com.tr

Arena tarafından geliştirilen kurumsal MCP çözümleri ve sunucuları.

💡 Katkıda Bulunma

Kendi MCP Sunucunuzu Paylaşın

  1. GitHub'da Yayınlayın

    git init
git add .
git commit -m "Initial commit"
git push origin main

  2. README Hazırlayın

    • Kurulum talimatları
    • Kullanım örnekleri
    • API dokümantasyonu

  3. Awesome Lists'e Ekleyin

    • Pull request oluşturun
    • Proje açıklaması ekleyin
    • Etiketler (tags) belirleyin

Topluluk Katkısı

  • 🐛 Bug Bildirimi: GitHub Issues
  • 💬 Tartışmalar: GitHub Discussions
  • 📝 Dokümantasyon: Wiki katkıları
  • 🌟 Star ve Fork: Projeleri destekleyin

🔗 Hızlı Bağlantılar

📚 Resmi Kaynaklar

🌟 Topluluk Kaynakları

  • Awesome MCP (wong2): GitHub - Topluluk listesi 1
  • Awesome MCP (punkpeye): GitHub - Topluluk listesi 2

📦 SDK ve Paketler

📅 Güncel Kalın

  • 📧 Newsletter: MCP güncellemeleri
  • 🐦 Twitter: @ModelContextP
  • 💬 Discord: Topluluk kanalları
  • 📺 YouTube: Video tutorial'lar

⚠️ Not

Bu kaynaklar topluluk tarafından oluşturulmuştur. Kullanmadan önce:

  • ✅ Lisans kontrolü yapın
  • ✅ Güvenlik incelemesi yapın
  • ✅ Dokümantasyonu okuyun
  • ✅ Test ortamında deneyin

Son Güncelleme: 31 Aralık 2025

Katkıda Bulunanlar: MCP Eğitim Ekibi