Servidor MCP Alpha Vantage
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso en tiempo real a datos del mercado financiero mediante la API gratuita Alpha Vantage . Este servidor implementa una interfaz estandarizada para recuperar cotizaciones de acciones e información de empresas.
Características
Cotizaciones de acciones en tiempo real con datos de precio, volumen y cambio
Información detallada de la empresa, incluido el sector, la industria y la capitalización de mercado.
Tipos de cambio de criptomonedas en tiempo real con precios de oferta y demanda
Datos de series temporales de criptomonedas diarios, semanales y mensuales
Datos históricos de la cadena de opciones con filtrado y clasificación avanzados
Manejo de errores integrado y gestión de límites de velocidad
Instalación
Uso de Claude Desktop
Instalación mediante Docker
cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
ruta 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 herrería
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
{
"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
Correr
Después de conectar el cliente Claude con la herramienta MCP a través del archivo json e instalar los paquetes, Claude debería ver las herramientas mcp del servidor:
Puede ejecutar el servidor usted mismo a través de: 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 `
Related MCP server: @qubaomingg/stock-mcp
Herramientas disponibles
El servidor implementa ocho herramientas:
get-stock-quote : Obtenga la última cotización de acciones de una empresa específica
get-company-info : Obtenga información relacionada con las acciones de una empresa específica
get-crypto-exchange-rate : Consulta los tipos de cambio actuales de criptomonedas
get-time-series : Obtenga datos históricos de precios diarios de una acción
get-historical-options : obtiene datos históricos de la cadena de opciones con capacidades de clasificación
get-crypto-daily : Obtenga datos de series temporales diarias para una criptomoneda
get-crypto-weekly : Obtenga datos de series temporales semanales para una criptomoneda
get-crypto-monthly : Obtenga datos de series temporales mensuales para una criptomoneda
obtener cotización de acciones
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
obtener información de la empresa
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
obtener tasa de cambio de criptomonedas
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
obtener series temporales
Recupera datos de series de tiempo 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
obtener opciones históricas
Recupera datos históricos de la cadena de opciones con capacidades avanzadas de clasificació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:
...
obtener criptomonedas diariamente
Recupera datos de series temporales diarias de una criptomoneda.
Esquema de entrada:
{
"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:
Daily cryptocurrency time series for SOL in USD:
Daily Time Series for Solana (SOL)
Market: United States Dollar (USD)
Last Refreshed: 2025-04-17 00:00:00 UTC
Date: 2025-04-17
Open: 131.31000000 USD
High: 131.67000000 USD
Low: 130.74000000 USD
Close: 131.15000000 USD
Volume: 39652.22195178
---
Date: 2025-04-16
Open: 126.10000000 USD
High: 133.91000000 USD
Low: 123.46000000 USD
Close: 131.32000000 USD
Volume: 1764240.04195810
---
Obtenga criptomonedas semanalmente
Recupera datos de series temporales semanales de una criptomoneda.
Esquema de entrada:
{
"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:
Weekly cryptocurrency time series for SOL in USD:
Weekly Time Series for Solana (SOL)
Market: United States Dollar (USD)
Last Refreshed: 2025-04-17 00:00:00 UTC
Date: 2025-04-17
Open: 128.32000000 USD
High: 136.00000000 USD
Low: 123.46000000 USD
Close: 131.15000000 USD
Volume: 4823091.05667581
---
Date: 2025-04-13
Open: 105.81000000 USD
High: 134.11000000 USD
Low: 95.16000000 USD
Close: 128.32000000 USD
Volume: 18015328.38860037
---
obtener criptomonedas mensualmente
Recupera datos de series de tiempo mensuales para una criptomoneda.
Esquema de entrada:
{
"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:
Monthly cryptocurrency time series for SOL in USD:
Monthly Time Series for Solana (SOL)
Market: United States Dollar (USD)
Last Refreshed: 2025-04-17 00:00:00 UTC
Date: 2025-04-17
Open: 124.51000000 USD
High: 136.18000000 USD
Low: 95.16000000 USD
Close: 131.15000000 USD
Volume: 34268628.85976021
---
Date: 2025-03-31
Open: 148.09000000 USD
High: 180.00000000 USD
Low: 112.00000000 USD
Close: 124.54000000 USD
Volume: 42360395.75443056
---
Manejo de errores
El servidor incluye un manejo integral de errores para diversos escenarios:
Límite de velocidad excedido
Clave API no válida
Problemas de conectividad de red
Manejo del tiempo de espera
Respuestas malformadas
Los mensajes de error se devuelven en un formato claro y legible para humanos.
Prerrequisitos
Python 3.12 o superior
httpx
mcp
Colaboradores
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
Licencia
Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.
