Skip to main content
Glama
fonlar-mcp

fonlar-mcp

by maku-cpu

fonlar-mcp

Türkiye'deki yatırım fonlarının (TEFAS) verilerini Claude'a sunan Model Context Protocol sunucusu.

Claude Desktop veya Claude Code üzerinden doğrudan TEFAS'a sorgu atmanı sağlar:

"AAK fonunun son fiyatı ve 1 yıllık getirisi nedir?"

"GO9 ve TTE fonlarını portföy ve performans olarak karşılaştır."

"İçinde 'altın' geçen fonları listele."

Özellikler

  • Kimlik bilgisi gerektirmez — TEFAS'ın public API'sini kullanır.

  • Stdio transport — yerel makinede çalışır, dışarı port açmaz.

  • Rate-limit dostu — TEFAS'ın 6 req/dk sınırına otomatik saygı.

  • 6 araç + 2 kaynak + 1 hazır prompt sunar.

Related MCP server: finhay-mcp-server

Araçlar (Tools)

Tool

Açıklama

get_fon_fiyat(fon_kodu)

Güncel fiyat, günlük getiri, portföy büyüklüğü

get_fon_fiyat_gecmisi(fon_kodu, periyod)

Hafta / 1ay / 3ay / 6ay / 1yıl / 3yıl / 5yıl geçmiş

get_fon_portfoy(fon_kodu, tarih?)

Kategori bazlı portföy dağılımı

karsilastir_fonlar(fon_1, fon_2, periyod)

İki fonun getiri ve portföy karşılaştırması

ara_fon(metin, limit)

Fon kodu / ünvan araması

donemsel_getiri_ozeti(fon_kodu)

1a/3a/6a/yb/1y/3y/5y getiri tablosu

Kurulum

1. Bağımlılıkları kur

git clone https://github.com/maku-cpu/fonlar-mcp.git
cd fonlar-mcp
uv sync

uv yüklü değilse: https://docs.astral.sh/uv/getting-started/installation/

2. Claude Desktop'a ekle

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "fonlar": {
      "command": "uv",
      "args": [
        "--directory", "/MUTLAK/PATH/fonlar-mcp",
        "run", "fonlar-mcp"
      ]
    }
  }
}

Claude Desktop'u kapat-aç. Sağ alttaki bağlantı ikonunda fonlar görünmeli.

3. Claude Code'a ekle

claude mcp add fonlar -- uv --directory /MUTLAK/PATH/fonlar-mcp run fonlar-mcp

veya proje kökünde .mcp.json:

{
  "mcpServers": {
    "fonlar": {
      "command": "uv",
      "args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
    }
  }
}

Diğer MCP Client'larla Kullanım

MCP standart bir protokol — Claude'a özel değil. fonlar-mcp aşağıdaki tüm client'larla aynı server kodu ile çalışır, sadece config dosyasının yeri/formatı değişir.

Cursor

~/.cursor/mcp.json veya proje kökünde .cursor/mcp.json:

{
  "mcpServers": {
    "fonlar": {
      "command": "uv",
      "args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "fonlar": {
      "command": "uv",
      "args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
    }
  }
}

Antigravity (Google)

Settings → MCP Servers, veya ~/.antigravity/mcp_settings.json:

{
  "mcpServers": {
    "fonlar": {
      "command": "uv",
      "args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
    }
  }
}

Zed

~/.config/zed/settings.json içinde context_servers bloğu:

{
  "context_servers": {
    "fonlar": {
      "command": {
        "path": "uv",
        "args": ["--directory", "/MUTLAK/PATH/fonlar-mcp", "run", "fonlar-mcp"]
      }
    }
  }
}

uv yoksa alternatif olarak doğrudan Python kullanılabilir: "command": "python3", "args": ["-m", "fonlar_mcp.server"], "env": {"PYTHONPATH": "/MUTLAK/PATH/fonlar-mcp/src"}

Test

MCP Inspector ile araçları manuel deneyebilirsin:

cd fonlar-mcp
npx @modelcontextprotocol/inspector uv run fonlar-mcp

Tarayıcıda açılan UI'dan tool'ları çağır, JSON çıktıyı gör.

Periyod Kodları

get_fon_fiyat_gecmisi ve karsilastir_fonlar aşağıdaki periyodları kabul eder:

hafta · 1ay · 3ay · 6ay · 1yil · 3yil · 5yil

Önemli Uyarı

Bu araç bilgilendirme amaçlıdır. TEFAS verilerini doğrudan iletir, yatırım tavsiyesi değildir. Yatırım kararlarınız size aittir.

Lisans

MIT — bkz. LICENSE.

Veri Kaynağı

Tüm veriler tefas.gov.tr public API'sinden alınır.

Available Tools

6 tools
ara_fonA

Fon kodu veya ünvanına göre TEFAS'ta fon arar / listeler.

Bu tool fon listeleme, filtreleme ve keşif için ana giriş noktasıdır. Kullanım örnekleri:

  • "Altın fonlarını listele" → ara_fon("altın")

  • "AK Portföy'ün tüm fonları" → ara_fon("AK PORTFÖY")

  • "Hangi BIST 30 fonları var?" → ara_fon("BIST 30")

  • "Teknoloji fonları neler?" → ara_fon("teknoloji")

Çoklu adımlı sorularda (örn: "altın fonlarının en getirili olanı") İLK ADIM olarak bu tool'u çağır, sonra dönen kodları diğer tool'lara (donemsel_getiri_ozeti, get_fon_portfoy vb.) besle.

Args: metin: Aranacak kelime/fon kodu (örn: "altın", "AK PORTFÖY", "TTE"). limit: Dönecek maksimum sonuç sayısı (default 20).

Inputs: metin (required), limit.

donemsel_getiri_ozetiB

Bir fonun standart dönemsel getirilerini (1a, 3a, 6a, yb, 1y, 3y, 5y) döner.

Args: fon_kodu: TEFAS fon kodu.

Inputs: fon_kodu (required).

get_fon_fiyatA

Bir fonun güncel fiyat ve günlük getiri bilgisini döner.

Args: fon_kodu: 3 karakterli TEFAS fon kodu (örn: "AAK", "GO9", "TTE").

Inputs: fon_kodu (required).

get_fon_fiyat_gecmisiB

Fonun günlük fiyat geçmişini döner.

Args: fon_kodu: TEFAS fon kodu. periyod: "hafta" | "1ay" | "3ay" | "6ay" | "1yil" | "3yil" | "5yil"

Inputs: fon_kodu (required), periyod.

get_fon_portfoyA

Bir fonun portföy dağılımını döner (kategori bazlı yüzdeler).

Args: fon_kodu: TEFAS fon kodu. tarih: YYYYMMDD formatında. Boş ise son iş günü kullanılır.

Inputs: fon_kodu (required), tarih.

karsilastir_fonlarA

İki fonun fiyat performansını ve portföy dağılımlarını karşılaştırır.

Args: fon_1: Birinci fon kodu. fon_2: İkinci fon kodu. periyod: Getiri karşılaştırması için periyod (hafta..5yil).

Inputs: fon_1 (required), fon_2 (required), periyod.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct operation: searching funds, getting period returns, current price, historical prices, portfolio distribution, and comparing two funds. There is no overlap in purpose.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern in Turkish (ara_fon, get_fon_fiyat, get_fon_fiyat_gecmisi, get_fon_portfoy, karsilastir_fonlar), but donemsel_getiri_ozeti uses a different structure (adjective_noun_noun), creating a minor inconsistency.

    Tool Count5/5

    With 6 tools, the set is well-scoped for a mutual fund information server. Each tool provides necessary functionality without unnecessary bloat or missing critical operations for common queries.

    Completeness4/5

    The tool set covers core fund operations: search, period returns, current and historical prices, portfolio composition, and comparison. Minor gaps include the inability to list all funds without a search term and lack of detailed fund metadata (e.g., management fees, fund manager).

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables Claude Desktop to access investment fund data in Turkey through the FonParam API, allowing users to list, compare, and analyze funds, view company statistics, and get inflation data.
      15
      45 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables querying real-time stock prices, gold, crypto, interest rates, portfolio data, and financial analysis from Finhay Securities via Claude AI.
      79 npm
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables natural language interaction with Toss Securities Open API for stock quotes, account management, and order placement via Claude.
      28
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to retrieve live BIST and global stock prices, cryptocurrency prices, exchange rates, currency conversion, and inflation data from free public sources without API keys.
      51
      MIT