무료 Alpha Vantage API를 통해 금융 시장 데이터에 실시간으로 접근할 수 있는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 주식 시세와 회사 정보를 검색하는 표준화된 인터페이스를 구현합니다.

특징

• 가격, 거래량, 변동 데이터를 포함한 실시간 주식 시가
• 섹터, 산업, 시가총액을 포함한 상세한 회사 정보
• 매수/매도 가격이 포함된 실시간 암호화폐 환율
• 일간, 주간, 월간 암호화폐 시계열 데이터
• 실시간 옵션 체인 데이터와 그리스 및 암시 변동성
• 고급 필터링 및 정렬 기능을 갖춘 과거 옵션 체인 데이터
• 보유 종목, 섹터 배분, 주요 지표를 포함한 종합적인 ETF 프로필 데이터
• 맞춤형 기간 확장 가능한 다가오는 실적 캘린더
• 연간 및 분기별 보고서가 포함된 과거 실적 데이터
• 내장된 오류 처리 및 속도 제한 관리

설치

클로드 데스크톱 사용

Docker 설치 중

• 저장소를 복제하고 Claude 데스크톱 클라이언트에서 사용할 로컬 이미지를 구축합니다

• claude_desktop_config.json를 실제 키로 대체하여 claude_desktop_config.json를 다음 항목과 일치하도록 변경합니다:

Alpha Vantage MCP Server

A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.

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

Installation

Using Claude Desktop

Installing via Docker

• Clone the repository and build a local image to be utilized by your Claude desktop client

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

• Change your claude_desktop_config.json to match the following, replacing REPLACE_API_KEY with your actual key:

claude_desktop_config.json path

• On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• On 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"
      }
    }
  }
}

Installing via Smithery

To install Alpha Vantage MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @berlinbra/alpha-vantage-mcp --client claude

Install packages

uv install -e .

Running

After connecting Claude client with the MCP tool via json file and installing the packages, Claude should see the server’s mcp tools:

You can run the sever yourself via: