{"_id":"fonparam-mcp","_rev":"6-a9dda42aaf48660178c240011bb5d6e8","name":"fonparam-mcp","dist-tags":{"latest":"1.0.5"},"versions":{"1.0.0":{"name":"fonparam-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","fonparam","turkish-funds","finance","investment"],"author":{"name":"Claude AI Assistant"},"license":"MIT","_id":"fonparam-mcp@1.0.0","maintainers":[{"name":"kemalersin","email":"mail@kemalersin.com"}],"bin":{"fonparam-mcp":"dist/index.js"},"dist":{"shasum":"0a5d34d090670275beb011c7e84e237e0c508e5c","tarball":"https://registry.npmjs.org/fonparam-mcp/-/fonparam-mcp-1.0.0.tgz","fileCount":13,"integrity":"sha512-KfJ8ZXhmNCQn6K18FFRgkdXrxdXxy2aNc2XUObbqgt/N2p0HqB7pRMwauL0f0xd8NVpiebZiUE1onzap3n50Vg==","signatures":[{"sig":"MEUCIAV4CeO1sKGk+i+T2/wU3Cu0et9/X+gVPM+T7ubYKlxUAiEA2SRQXkReSP+mtL9BC9Pgew5sh4hhqBfG0jCsWFxizQs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":209065},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"f898e1849ce4093421e297bb3a0b5ffcfcf7a51b","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"kemalersin","email":"mail@kemalersin.com"},"_npmVersion":"10.9.2","description":"MCP server for FonParam API - Turkish mutual funds data","directories":{},"_nodeVersion":"22.13.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.4.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fonparam-mcp_1.0.0_1758705422100_0.09595489588421113","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"fonparam-mcp","version":"1.0.1","keywords":["mcp","model-context-protocol","fonparam","turkish-funds","finance","investment"],"author":{"name":"Kemal Ersin YILMAZ"},"license":"MIT","_id":"fonparam-mcp@1.0.1","maintainers":[{"name":"kemalersin","email":"mail@kemalersin.com"}],"homepage":"https://github.com/kemalersin/fonparam-mcp#readme","bugs":{"url":"https://github.com/kemalersin/fonparam-mcp/issues"},"bin":{"fonparam-mcp":"dist/index.js"},"dist":{"shasum":"03a1effcf1431d488e819457b0ca538897e57245","tarball":"https://registry.npmjs.org/fonparam-mcp/-/fonparam-mcp-1.0.1.tgz","fileCount":13,"integrity":"sha512-U5Af3cJA27aEdS+NWLxoBwQwU0IeBrR//wszQKeNgVDti8zgGYNo6Rl6ll9U/BDtGk+IOFKxhYtsLqw4+WeUCg==","signatures":[{"sig":"MEUCIQCplwwSXC2VfuhTYbymMKRR8g8HPNzxkN12E25SNX7pbAIgdzf0yU0K6EsVzZNxn8Drz0OO1D9IGl2NlcFpqLvrRW8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":209495},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"53ef0a830637cc1778142f2bf127080767bfb2bc","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"kemalersin","email":"mail@kemalersin.com"},"repository":{"url":"git+https://github.com/kemalersin/fonparam-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for FonParam API - Turkish mutual funds data","directories":{},"_nodeVersion":"22.13.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.4.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fonparam-mcp_1.0.1_1758706168839_0.5691497635712699","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"fonparam-mcp","version":"1.0.2","keywords":["mcp","model-context-protocol","fonparam","turkish-funds","finance","investment"],"author":{"name":"Kemal Ersin YILMAZ"},"license":"MIT","_id":"fonparam-mcp@1.0.2","maintainers":[{"name":"kemalersin","email":"mail@kemalersin.com"}],"homepage":"https://github.com/kemalersin/fonparam-mcp#readme","bugs":{"url":"https://github.com/kemalersin/fonparam-mcp/issues"},"bin":{"fonparam-mcp":"dist/index.js"},"dist":{"shasum":"a72c31bcdbbf9ff7a0ec7fccdab256e217992db9","tarball":"https://registry.npmjs.org/fonparam-mcp/-/fonparam-mcp-1.0.2.tgz","fileCount":13,"integrity":"sha512-oVOWCwAAPTkry4VtkzY/ObOUKKz9cGlpZed1EQJEOTJD8i54zjbxn3wpiUERdCANfmDnbPrr1CaJ0p8HvplSbw==","signatures":[{"sig":"MEUCIQCNdHzrq60wEPZnYDj2kZEIHYu5wIaDdmsQrOml1XqbRwIgWSg0eRfw0K/3pG5ONxoWUH1JMe/6IqmOA8kJyk6xNNs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":209495},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"c050fe1e4482f6efd0648f6f9638a3c6b3006cd0","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"kemalersin","email":"mail@kemalersin.com"},"repository":{"url":"git+https://github.com/kemalersin/fonparam-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for FonParam API - Turkish mutual funds data","directories":{},"_nodeVersion":"22.13.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.4.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fonparam-mcp_1.0.2_1758706672365_0.40440428939139084","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"fonparam-mcp","version":"1.0.3","keywords":["mcp","model-context-protocol","fonparam","turkish-funds","finance","investment"],"author":{"name":"Kemal Ersin YILMAZ"},"license":"MIT","_id":"fonparam-mcp@1.0.3","maintainers":[{"name":"kemalersin","email":"mail@kemalersin.com"}],"homepage":"https://github.com/kemalersin/fonparam-mcp#readme","bugs":{"url":"https://github.com/kemalersin/fonparam-mcp/issues"},"bin":{"fonparam-mcp":"dist/index.js"},"dist":{"shasum":"ee255740121650eaedd1d1ff3184633c9cf63a6a","tarball":"https://registry.npmjs.org/fonparam-mcp/-/fonparam-mcp-1.0.3.tgz","fileCount":29,"integrity":"sha512-wBx8ryrUqohpOIUHCALAL8uRJy5qXTdkbsxa3lAtmAzJ+FDHTOwncNyThY0Z/BmMrt9jo5GzZXO7FPUSr82SVw==","signatures":[{"sig":"MEQCIFdcajLzk9KaxH8Gx8frII8vu7b4bPn5175yWSua0j5AAiALph8oGMgXMtuwElLbqCaqlaTTxRucIk0XFuHYD/BVkg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":336788},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"3f703c00ca754d56a0dfec2874c0951a1b4315a1","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"kemalersin","email":"mail@kemalersin.com"},"repository":{"url":"git+https://github.com/kemalersin/fonparam-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for FonParam API - Turkish mutual funds data","directories":{},"_nodeVersion":"22.13.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.4.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fonparam-mcp_1.0.3_1758707098454_0.9734062302820636","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"fonparam-mcp","version":"1.0.4","keywords":["mcp","model-context-protocol","fonparam","turkish-funds","finance","investment"],"author":{"name":"Kemal Ersin YILMAZ"},"license":"MIT","_id":"fonparam-mcp@1.0.4","maintainers":[{"name":"kemalersin","email":"mail@kemalersin.com"}],"homepage":"https://github.com/kemalersin/fonparam-mcp#readme","bugs":{"url":"https://github.com/kemalersin/fonparam-mcp/issues"},"bin":{"fonparam-mcp":"dist/index.js"},"dist":{"shasum":"fc29c5ba712a52a8ebd5a5ec414f39438253ec44","tarball":"https://registry.npmjs.org/fonparam-mcp/-/fonparam-mcp-1.0.4.tgz","fileCount":30,"integrity":"sha512-eFNUFd/YqVWDfXyZwmdwzI70otOOmtfqsVl0W1oqCzBCqG4VCusdvtJsSiXpeFT1TfBPD7qKUrt2+ICju5WaNQ==","signatures":[{"sig":"MEUCIGiLDjd8Khg87VRn4Z0rzZtkEsVXcTKRfX1ENmkDKLoKAiEA3b3PURcRUw34jRFvZG3mAtcGzw81jO95k2M6W1u9ipk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":337641},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"82a410ec3cd234dd4205b87e7a8cba6427875635","mcpName":"io.github.kemalersin/fonparam-mcp","scripts":{"dev":"tsc --watch","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"kemalersin","email":"mail@kemalersin.com"},"repository":{"url":"git+https://github.com/kemalersin/fonparam-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"MCP server for FonParam API - Turkish mutual funds data","directories":{},"_nodeVersion":"22.13.0","dependencies":{"zod":"^3.22.0","axios":"^1.6.0","@modelcontextprotocol/sdk":"^0.4.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/fonparam-mcp_1.0.4_1758719090468_0.5316764671668295","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"fonparam-mcp","version":"1.0.5","description":"MCP server for FonParam API - Turkish mutual funds data","mcpName":"io.github.kemalersin/fonparam-mcp","main":"dist/index.js","type":"module","scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","clean":"rm -rf dist"},"bin":{"fonparam-mcp":"dist/index.js"},"keywords":["mcp","model-context-protocol","fonparam","turkish-funds","finance","investment"],"author":{"name":"Kemal Ersin YILMAZ"},"repository":{"type":"git","url":"git+https://github.com/kemalersin/fonparam-mcp.git"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^0.4.0","axios":"^1.6.0","zod":"^3.22.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.3.0"},"gitHead":"42865aca7e4b2ca8532c067ac527f6265be460fe","types":"./dist/index.d.ts","_id":"fonparam-mcp@1.0.5","bugs":{"url":"https://github.com/kemalersin/fonparam-mcp/issues"},"homepage":"https://github.com/kemalersin/fonparam-mcp#readme","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-SQOUWW7ON5vHJa8X31fwMhkAH9EIBG2vGeMZzTC6iKTajV1JMPxocNNGcIk6gOzzTQwlsP48zrTAr/VoVvZbZA==","shasum":"f56c9818e806070456aa2516f99e872eedb658c9","tarball":"https://registry.npmjs.org/fonparam-mcp/-/fonparam-mcp-1.0.5.tgz","fileCount":29,"unpackedSize":301500,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDgHcaOF0vLe2F1XBaIyyP4o8RDNyn1JD6D6RkhkLfYdgIhAP4WH2HSjxKXmWr8nbIafUly8KY/EVm0ecS6vdSEhqbe"}]},"_npmUser":{"name":"kemalersin","email":"mail@kemalersin.com"},"directories":{},"maintainers":[{"name":"kemalersin","email":"mail@kemalersin.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fonparam-mcp_1.0.5_1780343910833_0.5844536282948534"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-24T09:17:02.099Z","modified":"2026-06-01T19:58:31.157Z","1.0.0":"2025-09-24T09:17:02.286Z","1.0.1":"2025-09-24T09:29:29.024Z","1.0.2":"2025-09-24T09:37:52.557Z","1.0.3":"2025-09-24T09:44:58.822Z","1.0.4":"2025-09-24T13:04:50.668Z","1.0.5":"2026-06-01T19:58:30.978Z"},"bugs":{"url":"https://github.com/kemalersin/fonparam-mcp/issues"},"author":{"name":"Kemal Ersin YILMAZ"},"license":"MIT","homepage":"https://github.com/kemalersin/fonparam-mcp#readme","keywords":["mcp","model-context-protocol","fonparam","turkish-funds","finance","investment"],"repository":{"type":"git","url":"git+https://github.com/kemalersin/fonparam-mcp.git"},"description":"MCP server for FonParam API - Turkish mutual funds data","maintainers":[{"name":"kemalersin","email":"mail@kemalersin.com"}],"readme":"# 📊 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. ","readmeFilename":"README.md"}