알파 밴티지 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.json - 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"
}
}
}
}
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>"
}
}
}
}
패키지 설치
달리기
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 `
사용 가능한 도구
서버는 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,011
get-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 키
- 네트워크 연결 문제
- 타임아웃 처리
- 잘못된 응답
오류 메시지는 사람이 읽을 수 있는 명확한 형식으로 반환됩니다.
필수 조건
기여자
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.