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

Clone el repositorio y cree una imagen local para que la utilice su cliente de escritorio Claude

cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .

Cambie su claude_desktop_config.json para que coincida con lo siguiente, reemplazando REPLACE_API_KEY con su clave real:

ruta claude_desktop_config.json
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 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

uv install -e .

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 `

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.

AlphaVantage-MCP

Integrations

Servidor MCP Alpha Vantage

Características

Instalación

Uso de Claude Desktop

Instalación mediante Docker

Instalación mediante herrería

Instalar paquetes

Correr

Herramientas disponibles

obtener cotización de acciones

obtener información de la empresa

obtener tasa de cambio de criptomonedas

obtener series temporales

obtener opciones históricas

obtener criptomonedas diariamente

Obtenga criptomonedas semanalmente

obtener criptomonedas mensualmente

Manejo de errores

Prerrequisitos

Colaboradores

Contribuyendo

Licencia

Tools

Related Resources

Appeared in Searches