Alpha Vantage MCP Server

Fornece dados do mercado financeiro em tempo real usando a API Alpha Vantage.

GitHub
2
Experimente este MCPPatrocinado

Documentação

Alpha Vantage MCP Server

smithery badge

Um servidor Model Context Protocol (MCP) que fornece acesso em tempo real a dados do mercado financeiro por meio da API Alpha Vantage gratuita. Este servidor implementa uma interface padronizada para obter cotações de ações e informações de empresas.

AlphaVantage-MCP MCP server

Recursos

  • Cotações de ações em tempo real com preço, volume e dados de variação
  • Informações detalhadas de empresas, incluindo setor, indústria e capitalização de mercado
  • Taxas de câmbio de criptomoedas em tempo real com preços de compra/venda
  • Dados históricos de cadeia de opções com filtragem e ordenação avançadas
  • Tratamento de erros integrado e gerenciamento de limites de taxa

Instalação

Usando o Claude Desktop

Instalando via Docker

  • Clone o repositório e crie uma imagem local para ser utilizada pelo seu cliente Claude Desktop
cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
  • Altere seu claude_desktop_config.json para corresponder ao seguinte, substituindo REPLACE_API_KEY pela sua chave real:

claude_desktop_config.json caminho

  • No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • No Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "alphavantage": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "ALPHA_VANTAGE_API_KEY",
        "mcp/alpha-vantage"
      ],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "REPLACE_API_KEY"
      }
    }
  }
}

Instalando via Smithery

Para instalar o Alpha Vantage MCP Server para o Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

Configuração de Servidores de Desenvolvimento/Não Publicados 

{
 "mcpServers": {
  "alpha-vantage-mcp": {
   "args": [
    "--directory",
    "/Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp",
    "run",
    "alpha-vantage-mcp"
   ],
   "command": "uv",
   "env": {
    "ALPHA_VANTAGE_API_KEY": "<insert api key>"
   }
  }
 }
}

Instalar pacotes

uv install -e .

Execução

Após conectar o cliente Claude à ferramenta MCP via arquivo json e instalar os pacotes, o Claude deverá ver as ferramentas mcp do servidor:

Você pode executar o servidor manualmente via: No repositório alpha-vantage-mcp:

uv run src/alpha_vantage_mcp/server.py

com inspector

* npx @modelcontextprotocol/inspector uv --directory /Users/{INSERT_USER}/YOUR/PATH/TO/alpha-vantage-mcp run src/alpha_vantage_mcp/server.py `

Ferramentas Disponíveis

O servidor implementa cinco ferramentas:

  • get-stock-quote: Obter a cotação de ação mais recente para uma empresa específica
  • get-company-info: Obter informações relacionadas a ações de uma empresa específica
  • get-crypto-exchange-rate: Obter taxas de câmbio atuais de criptomoedas
  • get-time-series: Obter dados históricos diários de preços de uma ação
  • get-historical-options: Obter dados históricos de cadeia de opções com recursos de ordenação

get-stock-quote

Esquema de Entrada:

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    }
}

Exemplo de Resposta:

Stock quote for AAPL:

Price: $198.50
Change: $2.50 (+1.25%)
Volume: 58942301
High: $199.62
Low: $197.20

get-company-info

Recupera informações detalhadas da empresa para um determinado símbolo.

Esquema de Entrada:

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    }
}

Exemplo de Resposta:

Company information for AAPL:

Name: Apple Inc
Sector: Technology
Industry: Consumer Electronics
Market Cap: $3000000000000
Description: Apple Inc. designs, manufactures, and markets smartphones...
Exchange: NASDAQ
Currency: USD

get-crypto-exchange-rate

Recupera taxas de câmbio de criptomoedas em tempo real com dados adicionais de mercado.

Esquema de Entrada:

{
    "crypto_symbol": {
        "type": "string",
        "description": "Cryptocurrency symbol (e.g., BTC, ETH)"
    },
    "market": {
        "type": "string",
        "description": "Market currency (e.g., USD, EUR)",
        "default": "USD"
    }
}

Exemplo de Resposta:

Cryptocurrency exchange rate for BTC/USD:

From: Bitcoin (BTC)
To: United States Dollar (USD)
Exchange Rate: 43521.45000
Last Updated: 2024-12-17 19:45:00 UTC
Bid Price: 43521.00000
Ask Price: 43522.00000

get-time-series

Recupera dados de séries temporais diárias (OHLCV).

Esquema de Entrada:

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    },
    "outputsize": {
        "type": "string",
        "description": "compact (latest 100 data points) or full (up to 20 years of data)",
        "default": "compact"
    }
}

Exemplo de Resposta:

Time Series Data for AAPL (Last Refreshed: 2024-12-17 16:00:00):

Date: 2024-12-16
Open: $195.09
High: $197.68
Low: $194.83
Close: $197.57
Volume: 55,751,011

get-historical-options

Recupera dados históricos de cadeia de opções com recursos avançados de ordenação e filtragem.

Esquema de Entrada:

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    },
    "date": {
        "type": "string",
        "description": "Optional: Trading date in YYYY-MM-DD format (defaults to previous trading day, must be after 2008-01-01)",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "limit": {
        "type": "integer",
        "description": "Optional: Number of contracts to return (default: 10, use -1 for all contracts)",
        "default": 10,
        "minimum": -1
    },
    "sort_by": {
        "type": "string",
        "description": "Optional: Field to sort by",
        "enum": ["strike", "expiration", "volume", "open_interest", "implied_volatility", "delta", "gamma", "theta", "vega", "rho", "last", "bid", "ask"],
        "default": "strike"
    },
    "sort_order": {
        "type": "string",
        "description": "Optional: Sort order",
        "enum": ["asc", "desc"],
        "default": "asc"
    }
}

Exemplo de Resposta:

Historical Options Data for AAPL (2024-02-20):

Contract 1:
Strike: $190.00
Expiration: 2024-03-15
Last: $8.45
Bid: $8.40
Ask: $8.50
Volume: 1245
Open Interest: 4567
Implied Volatility: 0.25
Greeks:
  Delta: 0.65
  Gamma: 0.04
  Theta: -0.15
  Vega: 0.30
  Rho: 0.25

Contract 2:
...

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para diversos cenários:

  • Limite de taxa excedido
  • Chave de API inválida
  • Problemas de conectividade de rede
  • Tratamento de timeout
  • Respostas malformadas

As mensagens de erro são retornadas em um formato claro e legível.

Pré-requisitos

  • Python 3.12 ou superior
  • httpx
  • mcp

Contribuidores

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.