Skip to main content
Glama
AlphaVantage-MCP

AlphaVantage-MCP

by berlinbra

Alpha Vantage MCP サーバー

鍛冶屋のバッジ

無料のAlpha Vantage APIを通じて金融市場データへのリアルタイムアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。このサーバーは、株価や企業情報を取得するための標準化されたインターフェースを実装しています。

特徴

  • 価格、出来高、変動データを含むリアルタイム株価

  • セクター、業界、時価総額を含む詳細な企業情報

  • リアルタイムの暗号通貨為替レートとビッド/アスク価格

  • 日次、週次、月次暗号通貨時系列データ

  • 高度なフィルタリングと並べ替えを備えた履歴オプションチェーンデータ

  • 組み込みのエラー処理とレート制限管理

インストール

Claudeデスクトップの使用

Docker経由でインストール

  • リポジトリをクローンし、Claude デスクトップ クライアントで使用するローカル イメージを構築します。

cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
  • claude_desktop_config.json次のように変更し、 REPLACE_API_KEY実際のキーに置き換えます。

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

履歴オプションを取得する

高度な並べ替えおよびフィルタリング機能を使用して、履歴オプション チェーン データを取得します。

入力スキーマ:

{
    "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:
...

暗号通貨を毎日入手

暗号通貨の毎日の時系列データを取得します。

入力スキーマ:

{
    "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
---

暗号通貨ウィークリー

暗号通貨の週次時系列データを取得します。

入力スキーマ:

{
    "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
---

毎月暗号通貨を入手する

暗号通貨の月次時系列データを取得します。

入力スキーマ:

{
    "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.
      -