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:

“Сын Фонунун Фияти ве 1 йыллык гейтириси недир?”

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

İçinde ‘altın’ geçen fonları listele.

Эзелликлер

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.

Araçlar (инструменты)

| Инструмент | Ачиклама [скрыто] [скрыто] [скрыто] [скрыто] get_fon_fiyat(fon_kodu) | Güncel fiyat, günlük getiri, portföy büyüklüğü | get_fon_fiyat_gecmisi(fon_kodu, periyod) | Хафта / 1ay / 3ay / 6ay / 1yıl / 3yıl / 5yıl geçmiş | get_fon_portfoy(fon_kodu, tarih?) | Kategori bazlı portföy dağılımı | [3] | Iki fonun getiri ve portföy karşılaştırması | ara_fon(metin, limit) | Фон коду / ünvan araması | donemsel_getiri_ozeti(fon_kodu) | 1a/3a/6a/yb/1y/3y/5y getiri tablosu |

##Курулум

###1.

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.

Araçlar (Tools)

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:

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