AlphaVantage-MCP
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.jsonpara que coincida con lo siguiente, reemplazandoREPLACE_API_KEYcon su clave real:
ruta
claude_desktop_config.json
En MacOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonEn 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.pycon 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: MCP Avantage
Herramientas disponibles
El servidor implementa ocho herramientas:
get-stock-quote: Obtenga la última cotización de acciones de una empresa específicaget-company-info: Obtenga información relacionada con las acciones de una empresa específicaget-crypto-exchange-rate: Consulta los tipos de cambio actuales de criptomonedasget-time-series: Obtenga datos históricos de precios diarios de una acciónget-historical-options: obtiene datos históricos de la cadena de opciones con capacidades de clasificaciónget-crypto-daily: Obtenga datos de series temporales diarias para una criptomonedaget-crypto-weekly: Obtenga datos de series temporales semanales para una criptomonedaget-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.20obtener 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: USDobtener 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.00000obtener 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,011obtener 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.
Available Tools
12 toolsget-company-infoC
Get detailed company information
Inputs: symbol (required).
get-crypto-dailyC
Get daily time series data for a cryptocurrency
Inputs: symbol (required), market.
get-crypto-exchange-rateB
Get current cryptocurrency exchange rate
Inputs: crypto_symbol (required), market.
get-crypto-monthlyC
Get monthly time series data for a cryptocurrency
Inputs: symbol (required), market.
get-crypto-weeklyC
Get weekly time series data for a cryptocurrency
Inputs: symbol (required), market.
get-earnings-calendarC
Get upcoming earnings calendar data for companies with sorting capabilities
Inputs: symbol, horizon, limit, sort_by, +1 more.
get-etf-profileB
Get comprehensive ETF profile information including holdings, sector allocation, and key metrics
Inputs: symbol (required).
get-historical-earningsC
Get historical earnings data for a specific company
Inputs: symbol (required), limit_annual, limit_quarterly.
get-historical-optionsC
Get historical options chain data for a stock with advanced filtering and sorting capabilities
Inputs: symbol (required), date, expiry_date, min_strike, +6 more.
get-realtime-optionsC
Get realtime options chain data for a stock with optional Greeks and filtering
Inputs: symbol (required), require_greeks, contract, datatype.
get-stock-quoteC
Get current stock quote information
Inputs: symbol (required).
get-time-seriesB
Get daily time series data for a stock with optional date filtering
Inputs: symbol (required), outputsize, start_date, end_date, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have distinct purposes targeting different financial data types (crypto, stocks, ETFs, earnings, options), but there is some overlap between get-crypto-daily, get-crypto-weekly, and get-crypto-monthly which all provide time series data for cryptocurrencies with only the timeframe differing. The descriptions help clarify, but an agent might need to carefully choose between these similar tools.
All tool names follow a consistent verb_noun pattern using 'get-' as the verb and descriptive nouns (e.g., get-company-info, get-crypto-daily). The naming is uniform throughout, making it predictable and easy to understand the purpose of each tool at a glance.
With 12 tools, this server is well-scoped for providing financial data from AlphaVantage. Each tool covers a specific aspect of the domain (e.g., time series, quotes, earnings, options), and none appear redundant or unnecessary, making the count appropriate for the server's purpose.
The tool set covers a broad range of financial data types including stocks, crypto, ETFs, earnings, and options with both historical and realtime capabilities. Minor gaps exist, such as no explicit tools for economic indicators or forex data, but core workflows for the stated purpose are well-covered and agents can likely work around these omissions.
Maintenance
Related MCP Connectors
MCP server for Financial Modeling Prep API with 250+ financial data tools
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.29MIT
- AlicenseCqualityDmaintenanceA Model Context Protocol server that enables LLMs to access comprehensive financial data from Alpha Vantage API, including stock prices, fundamentals, forex, crypto, and economic indicators.941Apache 2.0
- AlicenseAqualityDmaintenanceA minimal MCP server that provides stock snapshots including company metadata, latest quote, fundamentals, and daily price history via the Alpha Vantage API.1MIT
- FlicenseNot gradedqualityDmaintenanceA comprehensive MCP server that provides access to Alpha Vantage's financial data APIs, including stocks, forex, crypto, commodities, and economic indicators, enabling users to retrieve real-time quotes, historical data, technical indicators, and market intelligence through natural language.-