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