Skip to main content
Glama

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

📞 Destek

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


Bu proje faydalı olduysa star vermeyi unutmayın!

Made with ❤️ for Flutter Community

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/OrtakProje-1/flutter-package-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server