berlinbra/alpha-vantage-mcp logo

berlinbra/alpha-vantage-mcp

Free

Alpha Vantage API 集成,获取股票和加密货币信息。

FreeFree tier
Inputs: text
Type
Open Source

About berlinbra/alpha-vantage-mcp

Alpha Vantage MCP Server is a Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. It implements a standardized interface for retrieving stock quotes, company information, cryptocurrency exchange rates, historical time series data, real-time and historical options chain data with Greeks and implied volatility, comprehensive ETF profiles with holdings and sector allocation, and earnings calendars with annual and quarterly reports. Includes built-in error handling and rate limit management. The server can be installed via Docker, Smithery, or manually using uv, and integrates with MCP-compatible clients like Claude Desktop.

Key Features

Real-time stock quotes with price, volume, and change data
Detailed company information including sector, industry, and market cap
Real-time cryptocurrency exchange rates with bid/ask prices
Daily, weekly, and monthly cryptocurrency time series data
Real-time options chain data with Greeks and implied volatility
Historical options chain data with advanced filtering and sorting
Comprehensive ETF profile data with holdings, sector allocation, and key metrics
Upcoming earnings calendar with customizable time horizons
Historical earnings data with annual and quarterly reports
Built-in error handling and rate limit management

Pros & Cons

Pros
  • Free real-time financial data via the free Alpha Vantage API
  • Broad coverage of asset classes: stocks, crypto, options, ETFs, and earnings
  • Easy integration with MCP-compatible clients like Claude Desktop
  • Simple installation via Docker, Smithery, or manual setup
  • Open-source with MIT license, fully customizable
Cons
  • Requires an Alpha Vantage API key (free tier has rate limits of 5 calls per minute)
  • Dependence on Alpha Vantage service availability and uptime
  • Limited community size and documentation (new project with 103 stars)

Best For

Get stock quotes for investment monitoring and trading decisionsRetrieve company fundamentals for financial research and analysisTrack cryptocurrency exchange rates and historical trendsAnalyze options chain data including Greeks for options trading strategiesAccess ETF holdings and allocations for portfolio managementReview earnings calendars and historical earnings for fundamental analysis

FAQ

How do I install the Alpha Vantage MCP Server?
You can install it using Docker (build local image), via Smithery (npx command), or manually with uv. Detailed instructions are in the README.
What tools does the server provide?
The server provides twelve tools including get-stock-quote, get-company-info, get-crypto-exchange-rate, get-time-series, get-realtime-options, get-historical-options, and more.
Is an API key required?
Yes, you need an Alpha Vantage API key. You can obtain a free key from the Alpha Vantage website and set it as the ALPHA_VANTAGE_API_KEY environment variable.