Flutter Package MCP Server

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ı