Marktbewusster SIP-Timing-Berater — FastMCP (Workshop)

Ein ~180-zeiliger Python-MCP-Server, der Live-NSE-Indexdaten in eine SIP-Erhöhungs-/Pause-Empfehlung verwandelt. Entwickelt für das mfAPIs × SunitechAI-Webinar.

Design: Der Server besitzt keine Daten. Rohe NIFTY-50-KGV- und OHLC-Zeilen kommen von der MF Engine REST API; die Bewertungs-Perzentil-, Preistrend- und SIP-Regel-Logik lebt hier in Python. Genau diese Trennung ist der lehrreiche Teil.

Einrichtung

cd workshop/sip-advisor-mcp
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env      # then paste MFAPI_TOKEN

MFAPI_TOKEN ist ein JWT-access-token für einen Partner-/Investor-/Admin-Benutzer. Holen Sie es aus der Browser-Sitzung der zinni-app (DevTools → Application → Local Storage oder Network-Tab) oder über einen Login-API-Aufruf. Es ist nicht das statische MCP-Token — die REST-Endpunkte verwenden die normale Benutzerauthentifizierung.

Related MCP server: Quant Brain MCP

Ausführen

# stdio — for Claude Desktop
python server.py

# HTTP — for ChatGPT developer mode / remote clients  (serves :8000/mcp)
MCP_TRANSPORT=http python server.py

Schnelle Prüfung ohne LLM:

pip install fastmcp   # includes the CLI
fastmcp run server.py --transport http &
npx @modelcontextprotocol/inspector   # connect to http://localhost:8000/mcp

Mit Claude verbinden

Claude Desktop — integrieren Sie claude_desktop_config.example.json in ~/Library/Application Support/Claude/claude_desktop_config.json (absoluten Pfad + Token korrigieren), starten Sie Claude Desktop neu.

Claude Code

claude mcp add sip-advisor -- python /abs/path/workshop/sip-advisor-mcp/server.py
# set MFAPI_TOKEN in the shell that launches claude, or via --env

Mit ChatGPT verbinden

Führen Sie den Server im HTTP-Modus aus und machen Sie ihn erreichbar (cloudflared tunnel --url http://localhost:8000 oder ngrok http 8000), wählen Sie dann Settings → Connectors → Advanced → Developer mode → Add und fügen die URL https://…/mcp hinzu. Normale ChatGPT-Connectors benötigen die Tools search/fetch; dieser Server funktioniert nur über den Developer-Modus oder die Responses API.

Demo-Skript

„Ich habe einen NIFTY-50-SIP mit ₹10.000/Monat am Laufen. Angesichts der Marktlage: Sollte ich ihn erhöhen, halten oder pausieren?“

Das Modell verknüpft get_nifty_valuation_context → get_nifty_trend → recommend_sip_action(band, trend, 10000) und erläutert den Aufruf anhand des KGV-Perzentils, des Trends und des as_of-Datums.

Hinweis zur Datenaktualität

Die Produktions-NSE-OHLC-/Bewertungstabellen können dem Live-Markt um Wochen hinterherhinken. Die Tools geben as_of zurück — lesen Sie das in der Demo immer vor, und korrigieren Sie die Ingestion im Daten-Repository, bevor Sie live gehen.