Portfolio Tracker

Servidor MCP Portfolio Tracker

Um servidor Model Context Protocol (MCP) que expõe ferramentas de rastreamento de portfólio para clientes de IA.

Recursos

• Obter Posições do Portfólio: Recuperar todas as posições atuais
• Obter P&L do Portfólio: Calcular lucro/perda com atualização opcional de preços
• Atualizar Dados do Portfólio: Forçar atualização de todos os dados de preços do Yahoo Finance
• Obter Detalhes da Posição: Obter informações de posições específicas

Configuração

1. Instale as dependências:

npm install

2. Compile o projeto:

npm run build

3. Inicie o servidor:

npm start

Desenvolvimento

Para desenvolvimento com recarga automática:

npm run dev

Configuração do Cliente MCP

Claude Desktop

Adicione à sua configuração do 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"
      }
    }
  }
}

Variáveis de Ambiente

• PORTFOLIO_API_URL: URL base para a API do rastreador de portfólio (padrão: http://localhost:3000)
• DEBUG: Defina como "true" para registro detalhado (verbose logging)

Ferramentas Disponíveis

1. get_portfolio_positions

   • Obter todas as posições atuais do portfólio
   • Nenhum parâmetro necessário

2. get_portfolio_pnl

   • Obter análise de lucro/perda
   • Parâmetros: refresh (booleano, opcional) - forçar atualização de preços

3. refresh_portfolio_data

   • Forçar atualização de todos os dados de preços
   • Nenhum parâmetro necessário

4. get_position_details

   • Obter detalhes de posições específicas
   • Parâmetros: tickers (matriz de strings) - tickers específicos para consulta

Exemplos de Uso

Uma vez conectado a um cliente de IA, você pode perguntar:

• "Qual é o desempenho atual do meu portfólio?"
• "Mostre minhas posições"
• "Atualize os dados do meu portfólio e mostre o P&L"
• "Como está o desempenho da minha posição em NVDA?"