Skip to main content
Glama
FonParam MCP

FonParam MCP

by kemalersin

📊 FonParam MCP Sunucusu

Bu Model Context Protocol (MCP) sunucusu, Claude Desktop'un Türkiye'deki yatırım fonları verilerine erişmesini sağlar. FonParam API üzerinden fonların güncel verilerini, performans istatistiklerini ve karşılaştırmalarını alabilirsiniz.

✨ Ö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ı

Related MCP server: Financial Modeling Prep MCP Server

🚀 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

npm install

2. Projeyi Derleyin

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):

{
  "mcpServers": {
    "fonparam": {
      "command": "npx",
      "args": ["-y", "fonparam-mcp"],
      "env": {}
    }
  }
}

Kaynak koddan kurulum yaptıysanız:

{
  "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

# 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

⚠️ 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.

Available Tools

15 tools
analyze_fundC

Fon için yatırım analizi yapar

Inputs: code (required), startDate (required), initialInvestment (required), monthlyInvestment, +3 more.

company_detailsC

Portföy yönetim şirketi detaylarını getirir

Inputs: code (required), include_funds.

compare_fundsC

Fonları karşılaştırır (2-5 fon)

Inputs: codes (required).

fund_historical_dataC

Fonun geçmiş değerlerini getirir

Inputs: code (required), start_date, end_date, interval, +2 more.

fund_type_detailsC

Belirli bir fon tipinin detaylarını getirir

Inputs: type (required).

inflation_ratesC

Enflasyon verilerini listeler

Inputs: start_date, end_date.

latest_inflation_rateC

Son enflasyon verisini getirir

Inputs: no named parameters.

latest_statisticsC

Son istatistikleri getirir

Inputs: no named parameters.

list_companiesC

Portföy yönetim şirketlerini listeler

Inputs: page, limit, sort, order, +3 more.

list_fundsC

Yatırım fonlarını listeler ve filtreleme imkanı sunar

Inputs: page, limit, type, search, +7 more.

list_fund_typesC

Fon tiplerini listeler

Inputs: sort, order, min_total_funds, max_total_funds.

monthly_inflation_rateC

Belirli bir ay ve yıldaki enflasyon verisini getirir

Inputs: year (required), month (required).

statisticsC

Günlük istatistikleri listeler

Inputs: start_date, end_date, sort, order, +2 more.

statistics_by_dateC

Belirli bir günün istatistiklerini getirir

Inputs: date (required).

top_performing_fundsC

En iyi performans gösteren fonları getirir

Inputs: reference_funds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as analyze_fund for investment analysis and list_funds for listing funds. However, there is some overlap between inflation_rates, latest_inflation_rate, and monthly_inflation_rate, which could cause confusion in selecting the right tool for inflation data. Similarly, statistics, latest_statistics, and statistics_by_date have overlapping functions, though descriptions help differentiate them.

    Naming Consistency5/5

    Tool names follow a consistent snake_case pattern with clear verb_noun structures, such as list_funds, compare_funds, and fund_historical_data. There are no deviations in naming conventions, making the set predictable and easy to navigate for an agent.

    Tool Count5/5

    With 15 tools, the server is well-scoped for its domain of fund and investment analysis. Each tool appears to serve a specific purpose, such as analyzing funds, listing companies, or retrieving inflation data, without feeling excessive or insufficient for the apparent scope.

    Completeness4/5

    The tool set covers key areas like fund analysis, company details, inflation data, and statistics, providing good CRUD-like operations for the domain. Minor gaps exist, such as no explicit tools for updating or deleting data, but agents can likely work around these given the read-oriented nature of the server's purpose.

    Related MCP Connectors

    • Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.

      https://api.gloom.sh/mcp
    • A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com

      https://mcp.ceyloncharts.com/mcp
    • Connect Claude, ChatGPT, Codex, Claude Code or another MCP client to your real multi-broker investment portfolio. Fortunest tracks stocks, ETFs and crypto across brokers and exchanges; its MCP server lets your agent read holdings, returns, allocation, risk, trades and tax lots, calculated by Fortunest rather than guessed by the model. Reads run on their own; every change waits for your approval in the Fortunest app, and no tool places an order or moves money. Sign-in is OAuth 2.1 and needs Fortunest Pro (14-day trial, no card). A free demo that needs no account is listed as Fortunest demo.

      https://app.fortunest.ai/mcp
    • Licensed Borsa Istanbul (BIST) data for AI assistants: live or 15-minute delayed prices, OHLCV bars from 1 minute to monthly, financial statements, ratios, KAP disclosures, indices and sectors, indicator backtests and portfolio tracking for 600+ Turkish stocks. OAuth sign-in with an istfin subscription. Never places orders.

      https://mcp.istfin.com/mcp

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables Claude Desktop to access and analyze Chinese and global financial market data through the AKShare library.
      53
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      A Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.
      5
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides access to a fund knowledge base. Enables users to query and interact with financial fund information through natural language.
      3
      14 npm
      Apache 2.0