MCP Sunucu Kurulumu ve Claude Desktop ile Etkileşim

MCP Sunucu ve Claude Desktop Entegrasyonu

Bu uygulamalı eğitimle, AlphaVantage API üzerinden hisse senedi haber duyarlılığını ve günlük en iyi kazananları ve hareket edenleri sağlayan bir MCP (Model Context Protocol) sunucusu oluşturacağız. Bu çözüm, çoğu LLM’nin doğrudan gerçek zamanlı finansal verilere erişememesini ele alır. İki aracımız olacak: get_news_sentiment ve get_top_movers.

1. Ortamın Kurulması

Öncelikle uv paket yöneticisini kuracağız. Mac veya Linux için terminalde aşağıdaki komutu çalıştırın:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows üzerinden PowerShell ile:

powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"

Yenisınıf oluşturup uv ile başlatın:

uv init stockNews

Daha sonra, gerekli bağımlılıkları yükleyin:

uv add mcp httpx python-dotenv

2. Ortam Değişkenlerinin Ayarlanması

.env dosyasını oluşturun ve AlphaVantage API anahtarınızı ekleyin:

ALPHA_VANTAGE_API_KEY = your_api_key

3. MCP Sunucusunun Uygulanması

stockNews.py dosyasını oluşturun ve API çağrıları için gerekli olan kodu ekleyin. Tüm Python paketlerini içe aktarın ve FastMCP sunucusunu başlatın:

from typing import Any
import os
import httpx
from mcp.server.fastmcp import FastMCP
from dotenv import load_dotenv

load_dotenv()
API_KEY = os.getenv(\"ALPHA_VANTAGE_API_KEY\")
mcp = FastMCP(\"alpha-finance\")

Hisse haber duyarlılığı ve piyasa hareketlerini elde etmek için fonksiyonları tanımlayın:

async def call_alpha_vantage(endpoint: str, params: dict[str, Any]) -> dict[str, Any] | None:
    \"\"\"Generic async caller to Alpha Vantage.\"\"\"
    ...

4. Sunucunun Çalıştırılması

Sunucunuzu başlatmak için aşağıdaki satırı ekleyin:

if __name__ == \"__main__\":
    mcp.run(transport=\"stdio\")

5. Claude Desktop ile Test

Ayar dosyasını oluşturup Claude Desktop’u yeniden başlatın. Test için \”Apple için haber duyarlılığı nedir?\” gibi komutlar kullanabilirsiniz.