maku-cpu/fonlar-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

23 stars 2 forks 品質 79 トレンド 14MIT

Repository Install

TEFAS verilerini Claude'a sunan MCP sunucusu (Türk yatırım fonları)

概要

Türkiye'deki yatırım fonlarının (TEFAS) verilerini Claude'a sunan 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." - — TEFAS'ın public API'sini kullanır. - — yerel makinede çalışır, dışarı port açmaz. - — TEFAS'ın 6 req/dk sınırına otomatik saygı. - sunar. uv yüklü değilse: https://docs.astral.sh/uv/getting-started/installation/ ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) veya %APPDATA%\Claude\claude_desktop_config.json (Windows): Claude Desktop'u kapat-aç. Sağ alttaki bağlantı ikonunda fonlar görünmeli. MCP standart bir protokol — Claude'a özel değil. fonlar-mcp aşağıdaki tüm client'larla ile çalışır, sadece config dosyasının yeri/formatı değişir.

README

以下は原文 README の抜粋です。原文を見る。

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)

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:

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

GitHub で README 全文を見る

インストール

npx @modelcontextprotocol/inspector uv run fonlar-mcp

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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