Flutter Package MCP Server

A Model Context Protocol (MCP) server for Flutter packages, designed to integrate with AI assistants like Claude.

🚀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.

- 📦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

- Node.jsv18 veya üzeri (İndir)
- npmveyayarnpaket yöneticisi
- Claude Desktopveya MCP destekli bir AI client

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

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

%APPDATA%\Claude\claude_desktop_config.json

~/.config/Claude/claude_desktop_config.json

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

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

MCP ayarlarına şu konfigürasyonu ekleyin:

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

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

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

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

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

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

"Bu ay trend olan Flutter paketlerini göster"

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

# 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

# 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

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

- src/index.tsdosyasındaFlutterPackageMCPServersınıfına yeni method ekleyin
- setupToolHandlers()metodunda yeni tool'u tanımlayın
- CallToolRequestSchemahandler'ında yeni case ekleyin
- Build edin ve test edin

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

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

# 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

- 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

# İ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

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

Katkılarınızı memnuniyetle karşılıyoruz!
- Forkedin
- Feature brancholuşturun (git checkout -b feature/amazing-feature)
- Değişikliklerinizi commitedin (git commit -m 'Add amazing feature')
- Branch'inizi pushedin (git push origin feature/amazing-feature)
- Pull Requestoluşturun

- 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

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

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

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

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

An MCP server tailored for React Native–first development using Gluestack UI