Market-Aware SIP Timing Advisor — FastMCP (taller)

Un servidor MCP Python de ~180 líneas que convierte los datos en vivo del índic NSE en una recomendación de aument / pausa de SIP. Creado para el seminario web de mfAPIs × SunitechAI.

Diseño: el servidor no posee datis. Las filas brutas de PE y OHLC del NIFTY 50 provienen de la API REST de MF Engine; la lógica de percentil de valoration, tendencia de precio y reglas de SIP vive aquí en Python. Esa división es la parte didáctica.

Configuración

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 es un access-token JWT para un usuário socio / inversor / administrador. Obtenlo de la sesión de navegador de zinni-app (DevTools → Application → Local Storage, o la pestaña Networ k) o de una llamada a la API de inicio de sesión. No es el token estático de MCP: los endpoints REST usan la autenticación normal de usuário.

Related MCP server: Quant Brain MCP

Ejecutar

# stdio — for Claude Desktop
python server.py

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

Comprobación rápida sin un LLM:

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

Conectar con Claude

Claude Desktop — fusiona claude_desktop_config.example.json en ~/Library/Application Support/Claude/claude_desktop_config.json (corrige la ruta absoluta + token) y reinicia Claude Desktop.

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

Conectar con ChatGPT

Ejecuta en modo HTTP, expónlo (cloudflared tunnel --url http://localhost:8000 o ngrok http 8000) y luego ve a Ajustes → Conectores → Avanzado → Modo desarrollador → Añadir e introduce la URL https://…/mcp. Los conectores normales de ChatGPT necesitan herramientas search/fetch; este servidor funciona únicamente mediante modo desarrollador o la API Responses.

Guion de demostración

"Hago un SIP de ₹10,000 al mes en NIFTY 50. Dado dónde está el mercado, ¿debo aumentarlo, mantenerlo o pausarlo?"

El modelo encadena get_nifty_valuation_context → get_nifty_trend → recommend_sip_action(band, trend, 10000) y explica la decisión con el percentil de PE, la tendencia y la fecha as_of.

Nota sobre la actualidad de los datos

Las tablas de OHLC / valoración del NSE en producción pueden retrasarse con respecto al mercado en vivo durante semanas. Las herramientas devuelven as_of — menciónalo siempre en la demo y corrige la ingesta en el repositorio de datos antes de salir a producción.