Alpha Vantage MCP Sunucusu

Ücretsiz Alpha Vantage API aracılığıyla finansal pazar verilerine gerçek zamanlı erişim sağlayan bir Model Context Protocol (MCP) sunucusu. Bu sunucu, hisse senedi teklifleri ve şirket bilgilerini almak için standartlaştırılmış bir arayüz uygular.

Özellikler

• Fiyat, hacim ve değişim verileriyle gerçek zamanlı hisse senedi teklifleri
• Sektör, endüstri ve pazar değeri gibi ayrıntılı şirket bilgileri
• Alış/satış fiyatlarıyla gerçek zamanlı kripto para borsası kurları
• Günlük, haftalık ve aylık kripto para zaman serisi verileri
• Yunanca ve zımni oynaklıkla gerçek zamanlı opsiyon zinciri verileri
• Gelişmiş filtreleme ve sıralama özellikleriyle tarihi opsiyon zinciri verileri
• Varlıklar, sektör dağılımı ve temel metrikler içeren kapsamlı ETF profil verileri
• Özelleştirilebilir zaman ufuklarıyla yaklaşan kazanç takvimi
• Yıllık ve üç aylık raporlar içeren tarihi kazanç verileri
• Yerleşik hata işleme ve oran sınırı yönetimi

Kurulum

Claude Desktop Kullanımı

Docker Aracılığıyla Kurulum

• Repository'yi klonlayın ve Claude masaüstü istemciniz tarafından kullanılacak yerel bir görüntü oluşturun

cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .

• claude_desktop_config.json dosyasını aşağıdakiyle eşleşecek şekilde değiştirin, REPLACE_API_KEY yerine gerçek API anahtarınızı yazın:

claude_desktop_config.json yolu

• MacOS'ta: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows'ta: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "alphavantage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPHA_VANTAGE_API_KEY",
        "mcp/alpha-vantage"
      ],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "REPLACE_API_KEY"
      }
    }
  }
}

Smithery Aracılığıyla Kurulum

Alpha Vantage MCP Server'ı Claude Desktop için otomatik olarak Smithery aracılığıyla kurmak için:

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

{
 "mcpServers": {
  "alpha-vantage-mcp": {
   "args": [
    "--directory",
    "/Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp",
    "run",
    "alpha-vantage-mcp"
   ],
   "command": "uv",
   "env": {
    "ALPHA_VANTAGE_API_KEY": "<insert api key>"
   }
  }
 }
}

Paketleri yükleyin

uv install -e .

Çalıştırma

Claude istemcisini json dosyası aracılığıyla MCP aracı ile bağladıktan ve paketleri yükledikten sonra, Claude sunucunun MCP araçlarını görebilmelidir:

Sunucuyu aşağıdaki komutla kendiniz çalıştırabilirsiniz: alpha-vantage-mcp repository'sinde:

uv run src/alpha_vantage_mcp/server.py

inspector ile

* npx @modelcontextprotocol/inspector uv --directory /Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp run src/alpha_vantage_mcp/server.py `

Mevcut Araçlar

Sunucu on iki aracı uygular:

• get-stock-quote: Belirli bir şirket için en son hisse senedi teklifini alın
• get-company-info: Belirli bir şirket için hisse senedi ile ilgili bilgileri alın
• get-crypto-exchange-rate: Güncel kripto para borsası kurlarını alın
• get-time-series: Bir hisse senedi için geçmiş günlük fiyat verilerini alın
• get-realtime-options: Yunancalar ve zımni oynaklıkla gerçek zamanlı opsiyon zinciri verilerini alın
• get-historical-options: Gelişmiş filtreleme ve sıralama özellikleriyle tarihi opsiyon zinciri verilerini alın
• get-etf-profile: Varlıklar ve sektör dağılımı gibi kapsamlı ETF profil bilgilerini alın
• get-crypto-daily: Bir kripto para için günlük zaman serisi verilerini alın
• get-crypto-weekly: Bir kripto para için haftalık zaman serisi verilerini alın
• get-crypto-monthly: Bir kripto para için aylık zaman serisi verilerini alın
• get-earnings-calendar: Şirketler için yaklaşan kazanç takvimi verilerini alın
• get-historical-earnings: Belirli bir şirket için tarihi kazanç verilerini alın

get-stock-quote

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Hisse senedi sembolü (örn. AAPL, MSFT)"
    }
}

Örnek Yanıt:

AAPL için hisse senedi teklifi:

Fiyat: $198.50
Değişim: $2.50 (+1.25%)
Hacim: 58942301
Yüksek: $199.62
Düşük: $197.20

get-company-info

Verilen sembol için ayrıntılı şirket bilgilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Hisse senedi sembolü (örn. AAPL, MSFT)"
    }
}

Örnek Yanıt:

AAPL için şirket bilgileri:

İsim: Apple Inc
Sektör: Teknoloji
Endüstri: Tüketici Elektronikleri
Pazar Değeri: $3000000000000
Açıklama: Apple Inc. akıllı telefonlar tasarlayıp üretiyor...
Borsa: NASDAQ
Para Birimi: USD

get-crypto-exchange-rate

Ek pazar verileriyle gerçek zamanlı kripto para borsası kurlarını alır.

Input Şeması:

{
    "crypto_symbol": {
        "type": "string",
        "description": "Kripto para sembolü (örn. BTC, ETH)"
    },
    "market": {
        "type": "string",
        "description": "Pazar para birimi (örn. USD, EUR)",
        "default": "USD"
    }
}

Örnek Yanıt:

BTC/USD için kripto para borsası kuru:

Gönderen: Bitcoin (BTC)
Alan: United States Dollar (USD)
Borsası Kuru: 43521.45000
Son Güncelleme: 2024-12-17 19:45:00 UTC
Alış Fiyatı: 43521.00000
Satış Fiyatı: 43522.00000

get-time-series

İsteğe bağlı tarih filtrelemeyle günlük zaman serisi (OHLCV) verilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Hisse senedi sembolü (örn. AAPL, MSFT)"
    },
    "outputsize": {
        "type": "string",
        "description": "compact (en son 100 veri noktası) veya full (20 yıla kadar veri). start_date veya end_date belirtildiğinde, varsayılan olarak 'full'",
        "default": "compact"
    },
    "start_date": {
        "type": "string",
        "description": "İsteğe bağlı: Sonuçları filtrelemek için YYYY-MM-DD biçiminde başlangıç tarihi",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "end_date": {
        "type": "string",
        "description": "İsteğe bağlı: Sonuçları filtrelemek için YYYY-MM-DD biçiminde bitiş tarihi",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "limit": {
        "type": "integer",
        "description": "İsteğe bağlı: Tarih filtrelemesi uygulanmadığında döndürülecek veri noktalarının sayısı (varsayılan: 5)",
        "default": 5,
        "minimum": 1
    }
}

Örnek Yanıt (Son Veriler):

AAPL için Zaman Serisi Verileri (Son Yenileme: 2024-12-17 16:00:00):
(En son 5 veri noktası gösteriliyor)

Tarih: 2024-12-16
Açılış: $195.09
Yüksek: $197.68
Düşük: $194.83
Kapanış: $197.57
Hacim: 55,751,011
---
Tarih: 2024-12-13
Açılış: $194.50
Yüksek: $196.25
Düşük: $193.80
Kapanış: $195.12
Hacim: 48,320,567
---

Örnek Yanıt (Tarih Aralığı Filtreleme):

AAPL için Zaman Serisi Verileri (Son Yenileme: 2024-12-17 16:00:00):
Tarih Aralığı: 2024-12-01 ile 2024-12-07 (5 veri noktası)

Tarih: 2024-12-06
Açılış: $191.25
Yüksek: $193.80
Düşük: $190.55
Kapanış: $192.90
Hacim: 52,145,890
---
Tarih: 2024-12-05
Açılış: $189.75
Yüksek: $192.40
Düşük: $188.90
Kapanış: $191.30
Hacim: 47,892,345
---

get-realtime-options

İsteğe bağlı Yunanca hesaplaması ve sözleşme filtrelemesiyle gerçek zamanlı opsiyon zinciri verilerini alır.

⚠️ PREMIUM ABONE GEREKLI: Bu endpoint, 600 istek/dakika veya 1200 istek/dakika planıyla Alpha Vantage Premium gerektirir. Standart 75 istek/dakika planı ve ücretsiz hesaplar gerçek pazar verileri yerine yer tutucu/demo verileri alacaktır. Çoğu kullanım durumu için, tüm API anahtar seviyeleriyle çalışan get-historical-options kullanmayı düşünün.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Hisse senedi sembolü (örn. AAPL, MSFT)"
    },
    "require_greeks": {
        "type": "boolean",
        "description": "İsteğe bağlı: Yunanca ve zımni oynaklık hesaplamasını etkinleştir (varsayılan: false)",
        "default": false
    },
    "contract": {
        "type": "string",
        "description": "İsteğe bağlı: Alınacak belirli opsiyon sözleşmesi kimliği"
    },
    "datatype": {
        "type": "string",
        "description": "İsteğe bağlı: Yanıt biçimi (json veya csv, varsayılan: json)",
        "enum": ["json", "csv"],
        "default": "json"
    }
}

Örnek Yanıt:

AAPL için Gerçek Zamanlı Opsiyon Verileri
Son Güncelleme: 2025-01-21 16:00:00

=== Vade: 2025-01-24 ===

Strike: $220.0 (CALL)
Son: $5.25
Alış: $5.10
Satış: $5.30
Hacim: 1250
Açık Faiz: 8420
IV: 0.28
Delta: 0.65
Gamma: 0.02
Theta: -0.15
Vega: 0.45
Rho: 0.12
---

Strike: $220.0 (PUT)
Son: $1.85
Alış: $1.80
Satış: $1.90
Hacim: 820
Açık Faiz: 5240
IV: 0.25
Delta: -0.35
Gamma: 0.02
Theta: -0.12
Vega: 0.42
Rho: -0.08
---

Not: Yukarıdaki örnek, yalnızca Alpha Vantage Premium 600+ istek/dakika planlarında mevcut olan gerçek pazar verilerini göstermektedir. Ücretsiz hesapları veya 75 istek/dakika planları olan kullanıcılar yer tutucu verileri ("XXYYZZ" gibi semboller, "2099-99-99" gibi tarihler) görecek ve bunun yerine get-historical-options kullanmalıdır.

get-historical-options

Belirli sözleşmeleri bulmak için gelişmiş filtreleme ve sıralama özellikleriyle tarihi opsiyon zinciri verilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Hisse senedi sembolü (örn. AAPL, MSFT)"
    },
    "date": {
        "type": "string",
        "description": "İsteğe bağlı: YYYY-MM-DD biçiminde işlem tarihi (varsayılan: önceki işlem günü, 2008-01-01'den sonra olmalı)",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "expiry_date": {
        "type": "string",
        "description": "İsteğe bağlı: YYYY-MM-DD biçiminde vade sonunu filtrelemek",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "min_strike": {
        "type": "number",
        "description": "İsteğe bağlı: Minimum strike fiyatı filtresi (örn. 100.00)",
        "minimum": 0
    },
    "max_strike": {
        "type": "number",
        "description": "İsteğe bağlı: Maksimum strike fiyatı filtresi (örn. 200.00)",
        "minimum": 0
    },
    "contract_id": {
        "type": "string",
        "description": "İsteğe bağlı: Belirli sözleşme kimliğine göre filtreleme (örn. MSTR260116C00000500)"
    },
    "contract_type": {
        "type": "string",
        "description": "İsteğe bağlı: Sözleşme türüne göre filtreleme (call veya put)",
        "enum": ["call", "put", "C", "P"]
    },
    "limit": {
        "type": "integer",
        "description": "İsteğe bağlı: Filtrelemeden sonra döndürülecek sözleşme sayısı (varsayılan: 10, tüm sözleşmeler için -1 kullanın)",
        "default": 10,
        "minimum": -1
    },
    "sort_by": {
        "type": "string",
        "description": "İsteğe bağlı: Sıralanacak alan",
        "enum": ["strike", "expiration", "volume", "open_interest", "implied_volatility", "delta", "gamma", "theta", "vega", "rho", "last", "bid", "ask"],
        "default": "strike"
    },
    "sort_order": {
        "type": "string",
        "description": "İsteğe bağlı: Sıralama düzeni",
        "enum": ["asc", "desc"],
        "default": "asc"
    }
}

Örnek Yanıt (Temel):

AAPL için Tarihi Opsiyon Verileri (2024-02-20):
Durum: başarılı
156 sözleşme bulundu, sıralama: strike (asc)

Sözleşme Detayları:
Sözleşme Kimliği: AAPL240315C00190000
Vade: 2024-03-15
Strike: $190.00
Tür: call
Son: $8.45
Alış: $8.40
Satış: $8.50
Hacim: 1245
Açık Faiz: 4567
Zımni Oynaklık: 0.25
Yunancalar:
  Delta: 0.65
  Gamma: 0.04
  Theta: -0.15
  Vega: 0.30
  Rho: 0.25
---

Örnek Yanıt (Filtrelenmiş):

MSTR için Tarihi Opsiyon Verileri (2024-02-20):
Durum: başarılı
Filtreler: Vade: 2026-01-16, Strike: min $400 - max $600, Tür: call
3 sözleşme bulundu, sıralama: strike (asc)

Sözleşme Detayları:
Sözleşme Kimliği: MSTR260116C00000500
Vade: 2026-01-16
Strike: $500.00
Tür: call
Son: $125.30
Alış: $124.50
Satış: $126.10
Hacim: 89
Açık Faiz: 1234
---

get-etf-profile

Temel metrikler, sektör dağılımı ve en iyi varlıklar içeren kapsamlı ETF profil bilgilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "ETF sembolü (örn. QQQ, SPY, VTI)"
    }
}

Örnek Yanıt:

QQQ için ETF profili:

ETF Profili

Temel Bilgiler:
Net Varlıklar: $352,700,000,000
Net Gider Oranı: 0.200%
Portföy Devir: 8.0%
Temettü Verimi: 0.50%
Başlangıç Tarihi: 1999-03-10
Kaldıraçlı: HAYIR

Sektör Dağılımı:
BİLGİ TEKNOLOJİSİ: 51.9%
İLETİŞİM HİZMETLERİ: 15.4%
TÜKETİCİ İHTİYAÇLARI: 12.2%
TÜKETİCİ ÜRÜNLERI: 4.8%
SAĞLIK: 4.5%
SANAYİ: 4.4%
KAMUYİ HIZMETLER: 1.4%
MALZEMELER: 1.3%
ENERJİ: 0.5%
MALİYE: 0.4%

En İyi Varlıklar:
 1. NVDA - NVIDIA CORP: 9.80%
 2. MSFT - MICROSOFT CORP: 8.85%
 3. AAPL - APPLE INC: 7.35%
 4. AMZN - AMAZON.COM INC: 5.65%
 5. AVGO - BROADCOM INC: 5.14%
 6. META - META PLATFORMS INC CLASS A: 3.63%
 7. NFLX - NETFLIX INC: 3.10%
 8. TSLA - TESLA INC: 2.66%
 9. GOOGL - ALPHABET INC CLASS A: 2.49%
10. COST - COSTCO WHOLESALE CORP: 2.49%

... ve 92 daha fazla varlık

Toplam Varlıklar: 102

get-crypto-daily

Bir kripto para için günlük zaman serisi verilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Kripto para sembolü (örn. BTC, ETH)"
    },
    "market": {
        "type": "string",
        "description": "Pazar para birimi (örn. USD, EUR)",
        "default": "USD"
    }
}

Örnek Yanıt:

SOL'un USD'deki günlük kripto para zaman serisi:

Solana (SOL) için Günlük Zaman Serisi
Pazar: United States Dollar (USD)
Son Yenileme: 2025-04-17 00:00:00 UTC

Tarih: 2025-04-17
Açılış: 131.31000000 USD
Yüksek: 131.67000000 USD
Düşük: 130.74000000 USD
Kapanış: 131.15000000 USD
Hacim: 39652.22195178
---
Tarih: 2025-04-16
Açılış: 126.10000000 USD
Yüksek: 133.91000000 USD
Düşük: 123.46000000 USD
Kapanış: 131.32000000 USD
Hacim: 1764240.04195810
---

get-crypto-weekly

Bir kripto para için haftalık zaman serisi verilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Kripto para sembolü (örn. BTC, ETH)"
    },
    "market": {
        "type": "string",
        "description": "Pazar para birimi (örn. USD, EUR)",
        "default": "USD"
    }
}

Örnek Yanıt:

SOL'un USD'deki haftalık kripto para zaman serisi:

Solana (SOL) için Haftalık Zaman Serisi
Pazar: United States Dollar (USD)
Son Yenileme: 2025-04-17 00:00:00 UTC

Tarih: 2025-04-17
Açılış: 128.32000000 USD
Yüksek: 136.00000000 USD
Düşük: 123.46000000 USD
Kapanış: 131.15000000 USD
Hacim: 4823091.05667581
---
Tarih: 2025-04-13
Açılış: 105.81000000 USD
Yüksek: 134.11000000 USD
Düşük: 95.16000000 USD
Kapanış: 128.32000000 USD
Hacim: 18015328.38860037
---

get-crypto-monthly

Bir kripto para için aylık zaman serisi verilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "Kripto para sembolü (örn. BTC, ETH)"
    },
    "market": {
        "type": "string",
        "description": "Pazar para birimi (örn. USD, EUR)",
        "default": "USD"
    }
}

Örnek Yanıt:

SOL'un USD'deki aylık kripto para zaman serisi:

Solana (SOL) için Aylık Zaman Serisi
Pazar: United States Dollar (USD)
Son Yenileme: 2025-04-17 00:00:00 UTC

Tarih: 2025-04-17
Açılış: 124.51000000 USD
Yüksek: 136.18000000 USD
Düşük: 95.16000000 USD
Kapanış: 131.15000000 USD
Hacim: 34268628.85976021
---
Tarih: 2025-03-31
Açılış: 148.09000000 USD
Yüksek: 180.00000000 USD
Düşük: 112.00000000 USD
Kapanış: 124.54000000 USD
Hacim: 42360395.75443056
---

get-earnings-calendar

Özelleştirilebilir zaman ufuklarıyla ve sıralama özellikleriyle şirketlerin yaklaşan kazanç takvimi verilerini alır.

Input Şeması:

{
    "symbol": {
        "type": "string",
        "description": "İsteğe bağlı: Belirli bir şirketin kazançlarını filtrelemek için hisse senedi sembolü (örn. AAPL, MSFT, IBM)"
    },
    "horizon": {
        "type": "string",
        "description": "İsteğe bağlı: Kazanç verilerinin zaman ufku (3month, 6month veya 12month)",
        "enum": ["3month", "6month", "12month"],
        "default": "12month"
    },
    "limit": {
        "type": "integer",
        "description": "İsteğe bağlı: Döndürülecek kazanç girdilerinin sayısı (varsayılan: 100)",
        "default": 100,
        "minimum": 1
    },
    "sort_by": {
        "type": "string",
        "description": "İsteğe bağlı: Sıralanacak alan",
        "enum": ["reportDate", "symbol", "name", "fiscalDateEnding", "estimate"],
        "default": "reportDate"
    },
    "sort_order": {
        "type": "string",
        "description": "İsteğe bağlı: Sıralama düzeni",
        "enum": ["asc", "desc"],
        "default": "desc"
    }
}

Örnek Yanıt (Varsayılan - En Son Önce):

Kazanç takvimi (12month):

Yaklaşan Kazanç Takvimi (reportDate desc'e göre sıralanmış):

Şirket: NVDA - NVIDIA Corp
Rapor Tarihi: 2025-08-15
Mali Yıl Sonu: 2025-07-31
Tahmini: $4.25 USD
---
Şirket: AAPL - Apple Inc
Rapor Tarihi: 2025-07-30
Mali Yıl Sonu: 2025-06-30
Tahmini: $1.85 USD
---
Şirket: MSTR - MicroStrategy Inc
Rapor Tarihi: 2025-05-08
Mali Yıl Sonu: 2025-03-31
Tahmini: $1