Alpha Vantage

Servidor MCP Alpha Vantage

Um servidor Model Context Protocol (MCP) que fornece acesso às APIs de dados financeiros da Alpha Vantage para uso com Claude Desktop e outros aplicativos compatíveis com MCP.

🚀 Recursos

• Dados de Ações: Cotações em tempo real e preços diários históricos
• Demonstrações Financeiras: Demonstrações de resultados, balanços patrimoniais e fluxos de caixa
• Informações da Empresa: Visões gerais da empresa e dados de lucros
• Notícias e Sentimento: Últimas notícias financeiras com análise de sentimento
• Tratamento de Erros: Tratamento robusto de erros de API e gerenciamento de limites de taxa

📋 Pré-requisitos

1. Chave de API Alpha Vantage: Obtenha sua chave de API gratuita em Alpha Vantage
2. Python 3.8+: Certifique-se de ter o Python instalado
3. Claude Desktop: Ou outro aplicativo compatível com MCP

🛠️ Instalação

1. Clone o Repositório

git clone https://github.com/yourusername/alphavantage-mcp-server.git
cd alphavantage-mcp-server

2. Instale as Dependências

pip install -r requirements.txt

3. Obtenha Sua Chave de API

1. Visite Alpha Vantage
2. Cadastre-se para uma conta gratuita
3. Copie sua chave de API

⚙️ Configuração

Para Claude Desktop

Adicione esta configuração ao seu arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "alphavantage": {
      "command": "python3",
      "args": ["/path/to/alphavantage_server.py"],
      "env": {
        "ALPHAVANTAGE_API_KEY": "your_actual_api_key_here"
      }
    }
  }
}

Importante: Substitua /path/to/alphavantage_server.py pelo caminho real para seu script e your_actual_api_key_here pela sua chave de API Alpha Vantage.

🎯 Exemplos de Uso

Uma vez configurado, você pode pedir ao Claude:

• "Obtenha a cotação atual da ação da Apple (AAPL)"
• "Mostre-me a demonstração de resultados mais recente da Microsoft"
• "Quais são as últimas notícias sobre a ação da Tesla?"
• "Obtenha os dados do balanço patrimonial da Amazon"
• "Mostre-me a demonstração de fluxo de caixa do Google"

📊 Funções Disponíveis

Função	Descrição
get_stock_quote	Preço atual da ação e métricas básicas
get_daily_prices	Dados históricos de preços diários
get_income_statement	Demonstrações de resultados anuais
get_balance_sheet	Dados anuais do balanço patrimonial
get_cash_flow	Demonstrações anuais de fluxo de caixa
get_company_overview	Fundamentos da empresa e métricas-chave
get_news_sentiment	Últimas notícias com análise de sentimento
get_earnings	Dados de lucros trimestrais e anuais

🔧 Testes

Teste sua instalação executando o servidor diretamente:

export ALPHAVANTAGE_API_KEY="your_api_key"
python3 alphavantage_server.py

O servidor deve iniciar sem erros. Pressione Ctrl+C para parar.

📝 Limites da API

• Nível Gratuito: 25 solicitações/dia para endpoints premium, 500 solicitações/dia para endpoints padrão
• Limite de Taxa: 5 chamadas/minuto
• Níveis Premium: Disponíveis para limites mais altos

🐛 Solução de Problemas

Problemas Comuns

1. Erro "Servidor desconectado"

   • Verifique se sua chave de API está correta
   • Verifique o caminho do arquivo na sua configuração
   • Certifique-se de que as dependências estão instaladas

2. "ModuleNotFoundError: No module named 'mcp'"

   • Instale as dependências: pip install -r requirements.txt
   • Use o caminho correto do Python na sua configuração

3. Erros de limite de taxa da API

   • Você excedeu os limites do nível gratuito
   • Aguarde o limite de taxa ser redefinido ou faça upgrade do seu plano

🤝 Contribuindo

1. Faça um fork do repositório
2. Crie um branch de recurso (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
4. Envie para o branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

📄 Licença

Este projeto é licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🙏 Agradecimentos

• Alpha Vantage por fornecer a API de dados financeiros
• Anthropic por criar o Model Context Protocol
• A comunidade MCP pelas ferramentas e documentação

📞 Suporte

Se você encontrar problemas ou tiver dúvidas:

1. Verifique a seção de solução de problemas
2. Pesquise problemas existentes no GitHub
3. Crie um novo problema com informações detalhadas sobre o seu problema

---