alphavantage stock mcp

dados de ações, análise de ações

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP de Dados de Ações Alpha Vantage para Conta Gratuita

Idiomas do README: English | 中文

NPM Version License: MIT

Uma implementação em TypeScript/Node.js do servidor Model Context Protocol (MCP) para acessar dados históricos do mercado de ações por meio da API Alpha Vantage. Este servidor permite que LLMs e fluxos de trabalho agênticos interajam perfeitamente com dados financeiros.

⚠️ Somente Conta Gratuita Este servidor MCP foi projetado especificamente para contas gratuitas do Alpha Vantage. Ele utiliza apenas endpoints de API disponíveis no plano gratuito. Endpoints do plano pago não são suportados.

🚀 Recursos

  • Compatível com Conta Gratuita: Funciona inteiramente dentro dos limites da conta gratuita do Alpha Vantage
  • Dados Diários de Ações: Acessa séries temporais diárias com tamanhos de saída configuráveis
  • TypeScript: Suporte completo a TypeScript com definições de tipos
  • Protocolo MCP: Compatível com aplicativos habilitados para MCP, como Claude Desktop, VS Code e outros

📋 Pré-requisitos

  • Chave de API gratuita do Alpha Vantage

🔑 Obtendo uma Chave de API

  1. Cadastre-se para obter uma chave de API gratuita do Alpha Vantage
  2. Copie sua chave de API para integração com clientes MCP

🔌 Integração com Clientes MCP

Configuração JSON do MCP

Adicione esta configuração JSON:

{
  "mcpServers": {
    "alphavantage-stock-data": {  
      "command": "npx",
      "args": [
        "alphavantage-stock-mcp"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR-ALPHA-VANTAGE-API-KEY"
      }
    }
  }
}

🛠️ Ferramentas Disponíveis

get-stock-data

Busca dados de ações com um símbolo e intervalo especificados. Retorna os 100 pontos de dados mais recentes.

Parâmetros:

  • symbol (obrigatório): Símbolo da ação (ex.: "AAPL", "GOOGL", "MSFT")
  • interval (opcional): Intervalo de tempo - "daily", "weekly", "monthly" (padrão: "daily")

Exemplo de Uso:

Get the latest weekly data for Apple stock
Symbol: AAPL
Interval: weekly

🤝 Contribuindo

Aceitamos contribuições! Siga estes passos:

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

🙏 Agradecimentos