FonParam MCP

# 📊 FonParam MCP Sunucusu [](https://smithery.ai/server/@kemalersin/fonparam-mcp) Bu Model Context Protocol (MCP) sunucusu, Claude Desktop'un Türkiye'deki yatırım fonları verilerine erişmesini sağlar. [FonParam API](https://api.fonparam.com) üzerinden fonların güncel verilerini, performans istatistiklerini ve karşılaştırmalarını alabilirsiniz. <a href="https://glama.ai/mcp/servers/@kemalersin/fonparam-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@kemalersin/fonparam-mcp/badge" alt="FonParam MCP server" /> </a> ## ✨ Özellikler - 📈 **Fon Listeleme**: Tüm yatırım fonlarını filtreleme ve arama - 🔍 **Fon Karşılaştırma**: 2-5 fonu karşılaştırarak analiz etme - 📊 **Performans Analizi**: Fon yatırım analizi ve getiri hesaplaması - 🏢 **Şirket Bilgileri**: Portföy yönetim şirketleri ve istatistikleri - 📈 **Geçmiş Veriler**: Fonların tarihsel performans verileri - 📊 **İstatistikler**: Günlük piyasa istatistikleri - 💰 **Enflasyon Verileri**: Türkiye enflasyon oranları ## 🚀 Kurulum ### Seçenek 1: NPM ile Kurulum (Önerilen) NPM paketi otomatik olarak çalıştırılacağı için ayrı kurulum gerekmez. Claude Desktop konfigürasyonunda `npx` kullanarak paketi çalıştırabilirsiniz. ### Seçenek 2: Kaynak Koddan Kurulum #### 1. Bağımlılıkları Yükleyin ```bash npm install ``` #### 2. Projeyi Derleyin ```bash npm run build ``` ### Claude Desktop Konfigürasyonu Claude Desktop'ın `claude_desktop_config.json` dosyasına aşağıdaki konfigürasyonu ekleyin: #### Windows: ``` %APPDATA%\Claude\claude_desktop_config.json ``` #### macOS: ``` ~/Library/Application Support/Claude/claude_desktop_config.json ``` #### Linux: ``` ~/.config/Claude/claude_desktop_config.json ``` **Konfigürasyon:** #### NPM paketi kullanıyorsanız (önerilen): ```json { "mcpServers": { "fonparam": { "command": "npx", "args": ["-y", "fonparam-mcp"], "env": {} } } } ``` #### Kaynak koddan kurulum yaptıysanız: ```json { "mcpServers": { "fonparam": { "command": "node", "args": ["/tam/yol/to/fonparam-mcp/dist/index.js"], "env": {} } } } ``` > **Not**: Kaynak koddan kurulum için `/tam/yol/to/fonparam-mcp` kısmını projenizin gerçek yolu ile değiştirin. ### 4. Claude Desktop'ı Yeniden Başlatın Konfigürasyonu ekledikten sonra Claude Desktop'ı kapatıp yeniden açın. ## 🛠️ Kullanılabilir Araçlar ### 📊 Fon Araçları - **`list_funds`**: Fonları listeler ve filtreler - **`top_performing_funds`**: En iyi performans gösteren fonları getirir - **`compare_funds`**: Fonları karşılaştırır (2-5 fon) - **`analyze_fund`**: Fon yatırım analizi yapar - **`fund_historical_data`**: Fonun geçmiş değerlerini getirir ### 🏢 Şirket Araçları - **`list_companies`**: Portföy yönetim şirketlerini listeler - **`company_details`**: Şirket detaylarını getirir ### 📈 İstatistik Araçları - **`statistics`**: Günlük istatistikleri listeler - **`latest_statistics`**: En son istatistikleri getirir - **`statistics_by_date`**: Belirli tarihteki istatistikleri getirir ### 🎯 Fon Tipi Araçları - **`list_fund_types`**: Fon tiplerini listeler - **`fund_type_details`**: Fon tipi detaylarını getirir ### 💰 Enflasyon Araçları - **`inflation_rates`**: Enflasyon verilerini listeler - **`latest_inflation_rate`**: En son enflasyon verisini getirir - **`monthly_inflation_rate`**: Belirli ay/yıl enflasyon verisini getirir ## 💡 Kullanım Örnekleri ### Claude Desktop'ta Örnek Komutlar: ``` En iyi performans gösteren 10 fonu göster ``` ``` "ATA PORTFÖY" şirketine ait fonları listele ``` ``` AAK ve DAH fonlarını karşılaştır ``` ``` AAK fonuna 10.000 TL yatırıp yıl başından bugüne kadar kaç para olacağını hesapla ``` ``` Hisse senedi fonlarının bu ayki performansını göster ``` ``` Son enflasyon verilerini göster ``` ## 🔧 Geliştirme ### Scripts ```bash # TypeScript derlemesi (watch mode) npm run dev # Projeyi derle npm run build # Sunucuyu başlat npm start # Derleme dosyalarını temizle npm run clean ``` ### Proje Yapısı ``` src/ ├── index.ts # Ana MCP sunucusu ├── api-client.ts # FonParam API client ├── tools.ts # MCP araçları tanımları └── types.ts # TypeScript tip tanımları ``` ## 🤝 Katkıda Bulunma 1. Repoyu fork edin 2. Feature branch oluşturun (`git checkout -b feature/amazing-feature`) 3. Değişikliklerinizi commit edin (`git commit -m 'feat: amazing new feature'`) 4. Branch'inizi push edin (`git push origin feature/amazing-feature`) 5. Pull Request oluşturun ## 📜 Lisans Bu proje MIT lisansı altında lisanslanmıştır. ## 🔗 Bağlantılar - [FonParam API Dokümantasyonu](https://api.fonparam.com/api-docs) - [Model Context Protocol](https://modelcontextprotocol.io/) - [Claude Desktop](https://claude.ai/desktop) ## ⚠️ Not Bu sunucu FonParam API'sinin ücretsiz katmanını kullanır ve rate limiting kurallarına tabidir: - 15 dakikada maksimum 25 istek - Günlük maksimum 100 istek Yoğun kullanım için API anahtarı almayı düşünebilirsiniz.