Stock Market MCP Server

Servidor MCP de Mercado de Ações

Um servidor MCP baseado em TypeScript para obter dados do mercado de ações. Este servidor fornece informações em tempo real do mercado de ações e dados financeiros de empresas por meio da API Alpha Vantage.

Informações-chave para gerar este MCPServer

• .clinerules
• api-key

1.Plan mode

help me build a stock market mcp server that uses the AlphaVantage public API
I want it to have these tools：
- generate US market report/briefing
- generate financial statement for company
- get ticker price for company
- any other basic tools you think would be helpful
- api key: <you api key>


2. please test all the tools to confirm their functionality

Recursos

Ferramentas

• get_ticker_price - Obter preço de ação em tempo real

  • Requer o símbolo da ação como parâmetro
  • Retorna o preço mais recente da ação e o timestamp

• get_market_report - Obter relatório do mercado dos EUA

  • Fornece uma visão geral das condições gerais do mercado

• get_financial_statement - Obter demonstrações financeiras da empresa

  • Suporta três tipos de relatórios: demonstração de resultados (income), balanço patrimonial (balance) e fluxo de caixa (cashflow)
  • Requer o símbolo da ação e o tipo de relatório

• get_company_overview - Obter informações gerais da empresa

  • Requer o símbolo da ação
  • Retorna indicadores-chave e informações básicas da empresa

Configuração do ambiente de desenvolvimento

Instalar dependências

npm install

Compilar o projeto

npm run build

Modo de desenvolvimento (recompilação automática)

npm run watch

Instruções de instalação

Para usar este servidor no Claude Desktop, é necessário adicionar a configuração do servidor:

MacOS

Caminho do arquivo de configuração: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Caminho do arquivo de configuração: %APPDATA%/Claude/claude_desktop_config.json

Exemplo de configuração:

{
  "mcpServers": {
    "stock-market-server": {
      "command": "/path/to/stock-market-server/build/index.js"
    }
  }
}

Depuração

Como o servidor MCP se comunica por meio de entrada e saída padrão (stdio), a depuração pode ser difícil. Recomenda-se usar a ferramenta MCP Inspector para depuração:

npm run inspector

Após a execução, o Inspector fornecerá um endereço de acesso via navegador, permitindo o uso das ferramentas de depuração pelo navegador.

Pilha tecnológica

• TypeScript
• Node.js
• API Alpha Vantage
• SDK MCP (@modelcontextprotocol/sdk)

Observações

• É necessário ter uma chave de API Alpha Vantage válida antes do uso
• Todas as respostas da API são retornadas em formato JSON
• Esteja atento aos limites de frequência de chamadas da API Alpha Vantage

Licença

[Adicionar informações de licença]