Skip to main content
Glama
AlphaVantage-MCP

AlphaVantage-MCP

by berlinbra

알파 밴티지 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>"
   }
  }
 }
}

패키지 설치

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,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 키

  • 네트워크 연결 문제

  • 타임아웃 처리

  • 잘못된 응답

오류 메시지는 사람이 읽을 수 있는 명확한 형식으로 반환됩니다.

필수 조건

  • Python 3.12 이상

  • httpx

  • 엠씨피

기여자

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Available Tools

12 tools
get-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

    B3.4/5.0

    Scored across 12 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      This is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.
      2
      9
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      A 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.
      94
      1
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      A minimal MCP server that provides stock snapshots including company metadata, latest quote, fundamentals, and daily price history via the Alpha Vantage API.
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      -