AlphaVantage-MCP
알파 밴티지 MCP 서버
무료 Alpha Vantage API를 통해 금융 시장 데이터에 실시간으로 접근할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 주식 시세 및 회사 정보를 검색하기 위한 표준화된 인터페이스를 구현합니다.
특징
가격, 거래량, 변화 데이터가 포함된 실시간 주식 시세
부문, 산업 및 시가총액을 포함한 자세한 회사 정보
매수/매도 가격을 포함한 실시간 암호화폐 환율
일일, 주간, 월간 암호화폐 시계열 데이터
고급 필터링 및 정렬을 통한 과거 옵션 체인 데이터
내장된 오류 처리 및 속도 제한 관리
설치
Claude Desktop 사용
Docker를 통해 설치
저장소를 복제하고 Claude 데스크톱 클라이언트에서 활용할 로컬 이미지를 빌드합니다.
지엑스피1
REPLACE_API_KEY실제 키로 바꿔서claude_desktop_config.json을 다음과 일치하도록 변경하세요.
claude_desktop_config.json경로
MacOS의 경우:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows의 경우:
%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"
}
}
}
}Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 Alpha Vantage MCP Server를 자동으로 설치하려면:
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>"
}
}
}
}패키지 설치
uv install -e .달리기
JSON 파일을 통해 Claude 클라이언트를 MCP 도구에 연결하고 패키지를 설치한 후 Claude는 서버의 MCP 도구를 볼 수 있어야 합니다.
다음을 통해 서버를 직접 실행할 수 있습니다. alpha-vantage-mcp 리포지토리에서:
uv run src/alpha_vantage_mcp/server.py검사관과 함께
* 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
사용 가능한 도구
서버는 8개의 도구를 구현합니다.
get-stock-quote: 특정 회사의 최신 주식 시세를 받아보세요get-company-info: 특정 회사의 주식 관련 정보를 가져옵니다.get-crypto-exchange-rate: 현재 암호화폐 환율을 알아보세요get-time-series: 주식의 과거 일일 가격 데이터 가져오기get-historical-options: 정렬 기능을 사용하여 과거 옵션 체인 데이터를 가져옵니다.get-crypto-daily: 암호화폐에 대한 일일 시계열 데이터를 가져옵니다.get-crypto-weekly: 암호화폐에 대한 주간 시계열 데이터를 가져옵니다.get-crypto-monthly: 암호화폐에 대한 월별 시계열 데이터를 가져옵니다.
주식 시세 얻기
입력 스키마:
{
"symbol": {
"type": "string",
"description": "Stock symbol (e.g., AAPL, MSFT)"
}
}응답 예시:
Stock quote for AAPL:
Price: $198.50
Change: $2.50 (+1.25%)
Volume: 58942301
High: $199.62
Low: $197.20회사 정보 얻기
주어진 기호에 대한 자세한 회사 정보를 검색합니다.
입력 스키마:
{
"symbol": {
"type": "string",
"description": "Stock symbol (e.g., AAPL, MSFT)"
}
}응답 예시:
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암호화폐 환율 받기
추가적인 시장 데이터와 함께 실시간 암호화폐 환율을 검색합니다.
입력 스키마:
{
"crypto_symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}응답 예시:
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시계열 가져오기
일일 시계열(OHLCV) 데이터를 검색합니다.
입력 스키마:
{
"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"
}
}응답 예시:
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,011get-historical-options
고급 정렬 및 필터링 기능을 통해 과거 옵션 체인 데이터를 검색합니다.
입력 스키마:
{
"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"
}
}응답 예시:
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:
...get-crypto-daily
암호화폐에 대한 일일 시계열 데이터를 검색합니다.
입력 스키마:
{
"symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}응답 예시:
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
---get-crypto-weekly
암호화폐에 대한 주간 시계열 데이터를 검색합니다.
입력 스키마:
{
"symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}응답 예시:
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
---get-crypto-monthly
암호화폐에 대한 월별 시계열 데이터를 검색합니다.
입력 스키마:
{
"symbol": {
"type": "string",
"description": "Cryptocurrency symbol (e.g., BTC, ETH)"
},
"market": {
"type": "string",
"description": "Market currency (e.g., USD, EUR)",
"default": "USD"
}
}응답 예시:
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
---오류 처리
서버에는 다양한 시나리오에 대한 포괄적인 오류 처리 기능이 포함되어 있습니다.
요금 제한을 초과했습니다
잘못된 API 키
네트워크 연결 문제
타임아웃 처리
잘못된 응답
오류 메시지는 사람이 읽을 수 있는 명확한 형식으로 반환됩니다.
필수 조건
Python 3.12 이상
httpx
엠씨피
기여자
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.
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.-