Flutter Package MCP Server

🚀 Flutter paketleri için Model Context Protocol (MCP) server - Claude ve diğer AI asistanları ile Flutter paket ekosistemini entegre kullanın!

Pub.dev API'si ile entegre çalışarak Flutter paketlerinin güncel bilgilerini, versiyonlarını ve dokümantasyonlarını AI asistanınızın kullanımına sunar.

✨ Özellikler

• 📦 Paket Bilgileri: Güncel versiyon, açıklama, bağımlılıklar ve kurulum talimatları
• 🔍 Akıllı Arama: Anahtar kelime ile Flutter paket arama
• 📊 Versiyon Yönetimi: Tüm paket versiyonlarını listeleme ve karşılaştırma
• 📖 Kapsamlı Dokümantasyon: README, API dokümantasyonu ve özel dokümantasyon
• ⭐ Paket Değerlendirmesi: Popülerlik, kalite skorları ve topluluk beğenileri
• 🔥 Trend Analizi: En popüler ve trend olan paketleri keşfetme
• 🇹🇷 Türkçe Destek: Tamamen Türkçe arayüz ve açıklamalar

🛠️ Kurulum

Ön Koşullar

• Node.js v18 veya üzeri (İndir)
• npm veya yarn paket yöneticisi
• Claude Desktop veya MCP destekli bir AI client

1. Projeyi Klonlayın

git clone https://github.com/OrtakProje-1/flutter-package-mcp-server.git
cd flutter-package-mcp-server

2. Bağımlılıkları Yükleyin

npm install

3. Projeyi Build Edin

npm run build

4. Test Edin

npm run dev

Server başarıyla çalışırsa terminalden çıkmak için Ctrl+C kullanın.

🔧 MCP Client Kurulumu

Claude Desktop ile Kullanım

1. Claude Desktop Config Dosyasını Bulun:

   macOS:

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

   Windows:

   %APPDATA%\Claude\claude_desktop_config.json
   

   Linux:

   ~/.config/Claude/claude_desktop_config.json
   

2. Config dosyasını düzenleyin:

   {
     "mcpServers": {
       "flutter-packages": {
         "command": "node",
         "args": ["/FULL/PATH/TO/flutter-package-mcp-server/dist/index.js"],
         "env": {}
       }
     }
   }
   

   ⚠️ Önemli: /FULL/PATH/TO/flutter-package-mcp-server kısmını projenin gerçek tam yolu ile değiştirin.

3. Claude Desktop'ı yeniden başlatın

Cursor IDE ile Kullanım

1. Cursor ayarlarını açın (Cmd/Ctrl + ,)

2. MCP ayarlarına şu konfigürasyonu ekleyin:

   {
     "mcp": {
       "servers": {
         "flutter-packages": {
           "command": "node",
           "args": ["/FULL/PATH/TO/flutter-package-mcp-server/dist/index.js"]
         }
       }
     }
   }
   

3. Cursor'u yeniden başlatın

Diğer MCP Clientlar

Bu server, MCP standardını destekleyen herhangi bir client ile kullanılabilir. Server stdio üzerinden iletişim kurar.

🎯 Kullanım Örnekleri

Paket Bilgisi Alma

"http paketinin güncel bilgilerini ve kurulum talimatlarını getir"

Paket Arama

"state management için en iyi Flutter paketlerini ara"

Versiyon Karşılaştırması

"provider paketinin tüm versiyonlarını listele"

Dokümantasyon

"bloc paketinin detaylı dokümantasyonunu ve kullanım örneklerini getir"

Trend Analizi

"Bu ay trend olan Flutter paketlerini göster"

Paket Değerlendirmesi

"riverpod ve provider paketlerini karşılaştır, hangisi daha popüler?"

🛠️ Geliştirme

Geliştirme Ortamını Hazırlama

# Repository'yi fork edin ve klonlayın
git clone https://github.com/OrtakProje-1/flutter-package-mcp-server.git
cd flutter-package-mcp-server

# Bağımlılıkları yükleyin
npm install

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

Mevcut Scriptler

# TypeScript'i build et
npm run build

# Geliştirme modunda çalıştır (hot reload)
npm run dev

# Production modunda çalıştır
npm start

# Tip kontrolü
npm run type-check

Proje Yapısı

flutter-package-mcp-server/
├── src/
│   └── index.ts          # Ana server kodu
├── dist/                 # Build edilmiş dosyalar
├── package.json
├── tsconfig.json
└── README.md

Yeni Özellik Ekleme

1. src/index.ts dosyasında FlutterPackageMCPServer sınıfına yeni method ekleyin
2. setupToolHandlers() metodunda yeni tool'u tanımlayın
3. CallToolRequestSchema handler'ında yeni case ekleyin
4. Build edin ve test edin

📊 Mevcut API Araçları

Araç Adı	Açıklama	Parametreler
get_package_info	Paket detaylarını getirir	package_name: string
search_packages	Paket arama yapar	query: string, page?: number
get_package_versions	Tüm versiyonları listeler	package_name: string
get_package_documentation	Dokümantasyon getirir	package_name: string, version?: string
get_package_score	Paket skorlarını getirir	package_name: string
get_trending_packages	Trend paketleri listeler	page?: number

⚡ Performans ve Limitler

Pub.dev API Limitleri

• Rate Limiting: Saniyede 10 istek, dakikada 600 istek
• Günlük Limit: 36,000 istek/saat
• Timeout: 30 saniye

Optimizasyon İpuçları

• Sık kullanılan paketler için cache kullanımı planlanıyor
• Batch istekler gelecek versiyonda eklenecek

🐛 Sorun Giderme

Server Çalışmıyor

# Node.js versiyonunu kontrol edin
node --version  # v18+ olmalı

# Bağımlılıkları yeniden yükleyin
rm -rf node_modules package-lock.json
npm install

# Build işlemini tekrarlayın
npm run build

Claude Desktop Bağlantı Sorunu

1. Config dosyası konumunu doublcheck edin
2. JSON syntax'ının doğru olduğundan emin olun
3. Dosya yolunun mutlak path olduğunu kontrol edin
4. Claude Desktop'ı tamamen kapatıp açın

API Hataları

# İnternet bağlantısını test edin
curl https://pub.dev/api/packages/http

# DNS sorunları için
nslookup pub.dev

# Proxy ayarlarınızı kontrol edin
echo $HTTP_PROXY
echo $HTTPS_PROXY

Debug Modu

# Detaylı loglar için
DEBUG=* npm run dev

# Sadece MCP logları için
DEBUG=mcp:* npm run dev

🤝 Katkıda Bulunma

Katkılarınızı memnuniyetle karşılıyoruz!

Katkı Süreci

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request oluşturun

Geliştirme Kuralları

• TypeScript strict mode kullanın
• Her yeni özellik için test yazın
• Commit mesajlarında conventional commit formatını kullanın
• README'yi güncel tutun

İstenen Özellikler

• [ ] Package caching sistemi
• [ ] Offline mod desteği
• [ ] Batch API istekleri
• [ ] Package dependency tree görselleştirmesi
• [ ] Vulnerability checking
• [ ] License compatibility kontrolü

📄 Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

🙏 Teşekkürler

• Pub.dev - Flutter paket repository'si
• Model Context Protocol - AI entegrasyon standardı
• Claude - AI asistan platformu
• Flutter - Harika framework

📞 Destek

Sorularınız veya sorunlarınız için:

• 🐛 Bug Report: GitHub Issues
• 💡 Feature Request: GitHub Discussions
• 📧 İletişim: hasanuk98@gmail.com

---

⭐ Bu proje faydalı olduysa star vermeyi unutmayın!

Made with ❤️ for Flutter Community