Alpha Vantage MCP Server

Proporciona datos del mercado financiero en tiempo real utilizando la API de Alpha Vantage.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Alpha Vantage MCP Server

smithery badge

Un servidor de Model Context Protocol (MCP) que proporciona acceso en tiempo real a datos de mercados financieros a través de la API de Alpha Vantage gratuita. Este servidor implementa una interfaz estandarizada para obtener cotizaciones de acciones e información de empresas.

AlphaVantage-MCP MCP server

Características

  • Cotizaciones de acciones en tiempo real con precio, volumen y datos de variación
  • Información detallada de empresas, incluidos sector, industria y capitalización de mercado
  • Tipos de cambio de criptomonedas en tiempo real con precios de oferta y demanda
  • Datos históricos de cadenas de opciones con filtrado y ordenación avanzados
  • Manejo integrado de errores y gestión de límites de tasa

Instalación

Usando Claude Desktop

Instalación mediante Docker

  • Clona el repositorio y crea una imagen local para que la utilice tu cliente de escritorio de Claude
cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
  • Cambia tu claude_desktop_config.json para que coincida con lo siguiente, reemplazando REPLACE_API_KEY con tu clave real:

claude_desktop_config.json ruta

  • En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • En 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"
      }
    }
  }
}

Instalación mediante Smithery

Para instalar Alpha Vantage MCP Server para Claude Desktop automáticamente a través de Smithery:

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

Configuración de servidores de desarrollo/no 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 paquetes

uv install -e .

Ejecución

Después de conectar el cliente de Claude con la herramienta MCP mediante el archivo json e instalar los paquetes, Claude debería ver las herramientas mcp del servidor:

Puedes ejecutar el servidor tú mismo mediante: En el repositorio alpha-vantage-mcp:

uv run src/alpha_vantage_mcp/server.py

con inspector

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

Herramientas disponibles

El servidor implementa cinco herramientas:

  • get-stock-quote: Obtén la cotización de acciones más reciente para una empresa específica
  • get-company-info: Obtén información relacionada con acciones de una empresa específica
  • get-crypto-exchange-rate: Obtén los tipos de cambio actuales de criptomonedas
  • get-time-series: Obtén datos históricos de precios diarios de una acción
  • get-historical-options: Obtén datos históricos de cadenas de opciones con capacidades de ordenación

get-stock-quote

Esquema de entrada:

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

Ejemplo de respuesta:

Stock quote for AAPL:

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

get-company-info

Recupera información detallada de la empresa para un símbolo determinado.

Esquema de entrada:

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

Ejemplo de respuesta:

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 tipos de cambio de criptomonedas en tiempo real con datos de mercado adicionales.

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"
    }
}

Ejemplo de respuesta:

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 datos de series temporales diarias (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"
    }
}

Ejemplo de respuesta:

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 datos históricos de cadenas de opciones con capacidades avanzadas de ordenación y filtrado.

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"
    }
}

Ejemplo de respuesta:

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:
...

Manejo de errores

El servidor incluye un manejo integral de errores para diversos escenarios:

  • Límite de tasa superado
  • Clave de API no válida
  • Problemas de conectividad de red
  • Manejo de tiempos de espera
  • Respuestas mal formadas

Los mensajes de error se devuelven en un formato claro y legible para el ser humano.

Requisitos previos

  • Python 3.12 o superior
  • httpx
  • mcp

Contribuyentes

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una solicitud de extracción (Pull Request).

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que eres libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulta el archivo LICENSE en el repositorio del proyecto.