Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/OrtakProje-1/flutter-package-mcp-server.git
cd flutter-package-mcp-server
npm install
npm run buildRegister it in Claude Code
claude mcp add flutter-package-mcp -- node /FULL/PATH/TO/flutter-package-mcp-server/dist/index.jsReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
flutter-package-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Real-time access to package descriptions, dependencies, and installation instructions
- Keyword-based search functionality for the Pub.dev ecosystem
- Comprehensive version history listing and comparison
- Retrieval of README and API documentation for packages
- Evaluation of package popularity and quality scores
Tools 5
get_package_infoRetrieves detailed information about a specific Flutter package.search_packagesSearches for Flutter packages based on a query.get_package_versionsLists all available versions for a specific package.get_package_documentationRetrieves documentation for a specific package version.get_package_scoreRetrieves popularity and quality scores for a package.Try it
Original README from OrtakProje-1/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
Claude Desktop Config Dosyasını Bulun:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.jsonConfig 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-serverkı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.tsdosyasındaFlutterPackageMCPServersınıfına yeni method ekleyinsetupToolHandlers()metodunda yeni tool'u tanımlayınCallToolRequestSchemahandler'ı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 | `pa |