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

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

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.

Claude Desktop'ı yeniden başlatın

Cursor IDE ile Kullanım

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

MCP ayarlarına şu konfigürasyonu ekleyin:

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

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

src/index.ts dosyasında FlutterPackageMCPServer sınıfına yeni method ekleyin
setupToolHandlers() metodunda yeni tool'u tanımlayın
CallToolRequestSchema handler'ında yeni case ekleyin
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

Config dosyası konumunu doublcheck edin
JSON syntax'ının doğru olduğundan emin olun
Dosya yolunun mutlak path olduğunu kontrol edin
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

Fork edin
Feature branch oluşturun (git checkout -b feature/amazing-feature)
Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
Branch'inizi push edin (git push origin feature/amazing-feature)
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

📄 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