Servidor MCP de Portfolio Tracker

Un servidor de Model Context Protocol (MCP) que expone herramientas de seguimiento de cartera para clientes de IA.

Características

Obtener posiciones de la cartera: Recupera todas las posiciones actuales
Obtener P&L de la cartera: Calcula ganancias/pérdidas con actualización opcional de precios
Actualizar datos de la cartera: Fuerza la actualización de todos los datos de precios desde Yahoo Finance
Obtener detalles de posición: Obtén información de posiciones específicas

Configuración

Instala las dependencias:

npm install

Compila el proyecto:

npm run build

Inicia el servidor:

npm start

Desarrollo

Para desarrollo con recarga automática:

npm run dev

Configuración del cliente MCP

Claude Desktop

Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "portfolio-tracker": {
      "command": "node",
      "args": ["/Users/goul/Development/portfolio-tracker-mcp-server/build/index.js"],
      "env": {
        "PORTFOLIO_API_URL": "http://localhost:3000"
      }
    }
  }
}

Variables de entorno

PORTFOLIO_API_URL: URL base para la API del seguimiento de cartera (predeterminado: http://localhost:3000)
DEBUG: Establécelo en "true" para registro detallado (verbose logging)

Herramientas disponibles

get_portfolio_positions
- Obtén todas las posiciones actuales de la cartera
- No se requieren parámetros
get_portfolio_pnl
- Obtén análisis de ganancias/pérdidas
- Parámetros: refresh (booleano, opcional) - fuerza la actualización de precios
refresh_portfolio_data
- Fuerza la actualización de todos los datos de precios
- No se requieren parámetros
get_position_details
- Obtén detalles de posiciones específicas
- Parámetros: tickers (array de cadenas) - tickers específicos a consultar

Ejemplos de uso

Una vez conectado a un cliente de IA, puedes preguntar:

"¿Cuál es el rendimiento actual de mi cartera?"
"Muéstrame mis posiciones"
"Actualiza los datos de mi cartera y muestra el P&L"
"¿Cómo está rindiendo mi posición en NVDA?"

Portfolio Tracker

Documentación