mcpField
A
Alpha Vantage MCP Server

Alpha Vantage MCP Server

ローカル
github.com/berlinbra金融データ10453 週間前に更新

Alpha Vantage MCP Server について

Alpha Vantage MCP Server は、無料の Alpha Vantage API から金融市場データを提供する MCP サーバーです。株式、ETF、暗号資産、オプションを対象とし、AI アシスタントから株価や企業情報を照会したいユーザーに向けられています。

主な機能

  1. 01株価のリアルタイム取得と企業情報
  2. 02暗号資産の為替レートと時系列データ
  3. 03リアルタイムおよび履歴のオプションチェーンデータ
  4. 04保有銘柄と業種配分を含む ETF プロファイル
  5. 05決算カレンダーと過去の決算データ
  6. 06組み込みのエラー処理とレート制限管理

活用シーン

  1. 01AI アシスタントでの株価と企業ファンダメンタルズの照会
  2. 02暗号資産の日足・週足・月足データの分析
  3. 03ETF の保有銘柄と業種配分の確認
  4. 04今後の決算発表日の確認

MCP 対応

本プロジェクトは MCP サーバーであり、get-stock-quote、get-crypto-daily、get-earnings-calendar などの 12 のツールを MCP クライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"alpha-vantage": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"build"
]
}
}
}
起動コマンドdocker run -i --rm build

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocibuild

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Alpha Vantage MCP サーバー

smithery badge

無料の Alpha Vantage API を通じて、金融市場データにリアルタイムでアクセスできる Model Context Protocol(MCP)サーバーです。このサーバーは、株価情報や企業情報を取得するための標準化されたインターフェースを実装しています。

AlphaVantage-MCP MCP server

機能

  • 価格、出来高、変動データを含むリアルタイムの株価情報
  • セクター、業種、時価総額を含む詳細な企業情報
  • 買値/売値を含むリアルタイムの暗号資産為替レート
  • 暗号資産の日次、週次、月次の時系列データ
  • ギリシャ指標とインプライド・ボラティリティを含むリアルタイムのオプションチェーンデータ
  • 高度なフィルタリングと並べ替えが可能な過去のオプションチェーンデータ
  • 保有銘柄、セクター配分、主要指標を含む包括的な ETF プロファイルデータ
  • 期間をカスタマイズできる今後の決算カレンダー
  • 年次および四半期レポートを含む過去の決算データ
  • エラー処理とレート制限管理を内蔵

インストール

Claude Desktop を使用する
Docker 経由でインストールする
  • リポジトリをクローンし、Claude デスクトップクライアントで使用するローカルイメージをビルドします
cd alpha-vantage-mcp
docker build -t mcp/alpha-vantage .
  • 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 `

利用可能なツール

このサーバーは12個のツールを実装しています。

  • get-stock-quote:特定の企業の最新の株価情報を取得します
  • get-company-info:特定の企業の株式関連情報を取得します
  • get-crypto-exchange-rate:現在の暗号資産為替レートを取得します
  • get-time-series:株式の過去の日次価格データを取得します
  • get-realtime-options:ギリシャ指標とインプライド・ボラティリティを含むリアルタイムのオプションチェーンデータを取得します
  • get-historical-options:高度なフィルタリングと並べ替えが可能な、過去のオプションチェーンデータを取得します
  • get-etf-profile:保有銘柄とセクター配分を含む、包括的な ETF プロファイル情報を取得します
  • get-crypto-daily:暗号資産の日次時系列データを取得します
  • get-crypto-weekly:暗号資産の週次時系列データを取得します
  • get-crypto-monthly:暗号資産の月次時系列データを取得します
  • get-earnings-calendar:企業の今後の決算カレンダーデータを取得します
  • get-historical-earnings:特定の企業の過去の決算データを取得します
get-stock-quote

入力スキーマ:

{
    "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
get-company-info

指定されたシンボルの詳細な企業情報を取得します。

入力スキーマ:

{
    "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
get-crypto-exchange-rate

追加の市場データとともに、暗号資産のリアルタイム為替レートを取得します。

入力スキーマ:

{
    "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
get-time-series

任意の日付フィルタリングを指定して、日次時系列(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). When start_date or end_date is specified, defaults to 'full'",
        "default": "compact"
    },
    "start_date": {
        "type": "string",
        "description": "Optional: Start date in YYYY-MM-DD format for filtering results",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "end_date": {
        "type": "string",
        "description": "Optional: End date in YYYY-MM-DD format for filtering results",
        "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 data points to return when no date filtering is applied (default: 5)",
        "default": 5,
        "minimum": 1
    }
}

応答例(最近のデータ):

Time Series Data for AAPL (Last Refreshed: 2024-12-17 16:00:00):
(Showing 5 most recent data points)

Date: 2024-12-16
Open: $195.09
High: $197.68
Low: $194.83
Close: $197.57
Volume: 55,751,011
---
Date: 2024-12-13
Open: $194.50
High: $196.25
Low: $193.80
Close: $195.12
Volume: 48,320,567
---

応答例(日付範囲でフィルタリング):

Time Series Data for AAPL (Last Refreshed: 2024-12-17 16:00:00):
Date Range: 2024-12-01 to 2024-12-07 (5 data points)

Date: 2024-12-06
Open: $191.25
High: $193.80
Low: $190.55
Close: $192.90
Volume: 52,145,890
---
Date: 2024-12-05
Open: $189.75
High: $192.40
Low: $188.90
Close: $191.30
Volume: 47,892,345
---
get-realtime-options

オプションのギリシャ指標計算と契約フィルタリングを指定して、株式のリアルタイムオプションチェーンデータを取得します。

⚠️ PREMİUM SUBSCRIPTION REQUIRED: このエンドポイントを利用するには、Alpha Vantage Premium の毎分 600 リクエストまたは毎分 1200 リクエストのプランが必要です。標準の毎分 75 リクエストのプランおよび無料アカウントでは、実際の市場データの代わりにプレースホルダー/デモデータが返されます。ほとんどの用途では、すべての API キーのティアで利用できる get-historical-options の使用をご検討ください。

入力スキーマ:

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol (e.g., AAPL, MSFT)"
    },
    "require_greeks": {
        "type": "boolean",
        "description": "Optional: Enable Greeks and implied volatility calculation (default: false)",
        "default": false
    },
    "contract": {
        "type": "string",
        "description": "Optional: Specific options contract ID to retrieve"
    },
    "datatype": {
        "type": "string",
        "description": "Optional: Response format (json or csv, default: json)",
        "enum": ["json", "csv"],
        "default": "json"
    }
}

レスポンスの例:

Realtime Options Data for AAPL
Last Updated: 2025-01-21 16:00:00

=== Expiration: 2025-01-24 ===

Strike: $220.0 (CALL)
Last: $5.25
Bid: $5.10
Ask: $5.30
Volume: 1250
Open Interest: 8420
IV: 0.28
Delta: 0.65
Gamma: 0.02
Theta: -0.15
Vega: 0.45
Rho: 0.12
---

Strike: $220.0 (PUT)
Last: $1.85
Bid: $1.80
Ask: $1.90
Volume: 820
Open Interest: 5240
IV: 0.25
Delta: -0.35
Gamma: 0.02
Theta: -0.12
Vega: 0.42
Rho: -0.08
---

注記: 上記の例は、Alpha Vantage Premium の毎分 600 リクエスト以上のプランでのみ利用できる実際の市場データを示しています。無料アカウントまたは毎分 75 リクエストのプランでは、プレースホルダーデータ(「XXYYZZ」のようなシンボルや「2099-99-99」のような日付)が表示されるため、代わりに get-historical-options を使用してください。

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])$"
    },
    "expiry_date": {
        "type": "string",
        "description": "Optional: Filter by expiration date in YYYY-MM-DD format",
        "pattern": "^20[0-9]{2}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12][0-9]|3[01])$"
    },
    "min_strike": {
        "type": "number",
        "description": "Optional: Minimum strike price filter (e.g., 100.00)",
        "minimum": 0
    },
    "max_strike": {
        "type": "number",
        "description": "Optional: Maximum strike price filter (e.g., 200.00)",
        "minimum": 0
    },
    "contract_id": {
        "type": "string",
        "description": "Optional: Filter by specific contract ID (e.g., MSTR260116C00000500)"
    },
    "contract_type": {
        "type": "string",
        "description": "Optional: Filter by contract type (call or put)",
        "enum": ["call", "put", "C", "P"]
    },
    "limit": {
        "type": "integer",
        "description": "Optional: Number of contracts to return after filtering (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):
Status: success
Found 156 contracts, sorted by: strike (asc)

Contract Details:
Contract ID: AAPL240315C00190000
Expiration: 2024-03-15
Strike: $190.00
Type: call
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
---

レスポンスの例(フィルタリング済み):

Historical Options Data for MSTR (2024-02-20):
Status: success
Filters: Expiry: 2026-01-16, Strike: min $400 - max $600, Type: call
Found 3 contracts, sorted by: strike (asc)

Contract Details:
Contract ID: MSTR260116C00000500
Expiration: 2026-01-16
Strike: $500.00
Type: call
Last: $125.30
Bid: $124.50
Ask: $126.10
Volume: 89
Open Interest: 1234
---
get-etf-profile

基本指標、セクター配分、上位保有銘柄など、ETF の包括的なプロファイル情報を取得します。

入力スキーマ:

{
    "symbol": {
        "type": "string",
        "description": "ETF symbol (e.g., QQQ, SPY, VTI)"
    }
}

レスポンスの例:

ETF profile for QQQ:

ETF Profile

Basic Information:
Net Assets: $352,700,000,000
Net Expense Ratio: 0.200%
Portfolio Turnover: 8.0%
Dividend Yield: 0.50%
Inception Date: 1999-03-10
Leveraged: NO

Sector Allocation:
INFORMATION TECHNOLOGY: 51.9%
COMMUNICATION SERVICES: 15.4%
CONSUMER DISCRETIONARY: 12.2%
CONSUMER STAPLES: 4.8%
HEALTHCARE: 4.5%
INDUSTRIALS: 4.4%
UTILITIES: 1.4%
MATERIALS: 1.3%
ENERGY: 0.5%
FINANCIALS: 0.4%

Top Holdings:
 1. NVDA - NVIDIA CORP: 9.80%
 2. MSFT - MICROSOFT CORP: 8.85%
 3. AAPL - APPLE INC: 7.35%
 4. AMZN - AMAZON.COM INC: 5.65%
 5. AVGO - BROADCOM INC: 5.14%
 6. META - META PLATFORMS INC CLASS A: 3.63%
 7. NFLX - NETFLIX INC: 3.10%
 8. TSLA - TESLA INC: 2.66%
 9. GOOGL - ALPHABET INC CLASS A: 2.49%
10. COST - COSTCO WHOLESALE CORP: 2.49%

... and 92 more holdings

Total Holdings: 102
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
---
get-earnings-calendar

期間と並べ替え方法をカスタマイズして、企業の今後の決算カレンダーデータを取得します。

入力スキーマ:

{
    "symbol": {
        "type": "string",
        "description": "Optional: Stock symbol to filter earnings for a specific company (e.g., AAPL, MSFT, IBM)"
    },
    "horizon": {
        "type": "string",
        "description": "Optional: Time horizon for earnings data (3month, 6month, or 12month)",
        "enum": ["3month", "6month", "12month"],
        "default": "12month"
    },
    "limit": {
        "type": "integer",
        "description": "Optional: Number of earnings entries to return (default: 100)",
        "default": 100,
        "minimum": 1
    },
    "sort_by": {
        "type": "string",
        "description": "Optional: Field to sort by",
        "enum": ["reportDate", "symbol", "name", "fiscalDateEnding", "estimate"],
        "default": "reportDate"
    },
    "sort_order": {
        "type": "string",
        "description": "Optional: Sort order",
        "enum": ["asc", "desc"],
        "default": "desc"
    }
}

レスポンスの例(デフォルト — 新しい順):

Earnings calendar (12month):

Upcoming Earnings Calendar (Sorted by reportDate desc):

Company: NVDA - NVIDIA Corp
Report Date: 2025-08-15
Fiscal Date End: 2025-07-31
Estimate: $4.25 USD
---
Company: AAPL - Apple Inc
Report Date: 2025-07-30
Fiscal Date End: 2025-06-30
Estimate: $1.85 USD
---
Company: MSTR - MicroStrategy Inc
Report Date: 2025-05-08
Fiscal Date End: 2025-03-31
Estimate: $1.30 USD
---
Company: MSTR - MicroStrategy Inc
Report Date: 2025-02-06
Fiscal Date End: 2024-12-31
Estimate: $1.25 USD
---

レスポンスの例(シンボル順):

Earnings calendar (12month):

Upcoming Earnings Calendar (Sorted by symbol asc):

Company: AAPL - Apple Inc
Report Date: 2025-07-30
Fiscal Date End: 2025-06-30
Estimate: $1.85 USD
---
Company: GOOGL - Alphabet Inc
Report Date: 2025-04-25
Fiscal Date End: 2025-03-31
Estimate: $2.15 USD
---
Company: MSTR - MicroStrategy Inc
Report Date: 2025-02-06
Fiscal Date End: 2024-12-31
Estimate: $1.25 USD
---
get-historical-earnings

特定の企業について、年次および四半期のレポートを含む過去の決算データを取得します。

入力スキーマ:

{
    "symbol": {
        "type": "string",
        "description": "Stock symbol for the company (e.g., AAPL, MSFT, IBM)"
    },
    "limit_annual": {
        "type": "integer",
        "description": "Optional: Number of annual earnings to return (default: 5)",
        "default": 5,
        "minimum": 1
    },
    "limit_quarterly": {
        "type": "integer",
        "description": "Optional: Number of quarterly earnings to return (default: 8)",
        "default": 8,
        "minimum": 1
    }
}

レスポンスの例:

Historical Earnings for MSTR:

=== ANNUAL EARNINGS ===
Fiscal Year End: 2023-12-31
Reported EPS: $5.40
---
Fiscal Year End: 2022-12-31
Reported EPS: $-9.98
---

=== QUARTERLY EARNINGS ===
Fiscal Quarter End: 2024-09-30
Reported Date: 2024-10-30
Reported EPS: $1.10
Estimated EPS: $0.98
Surprise: +$0.12 (+12.24%)
Report Time: post-market
---
Fiscal Quarter End: 2024-06-30
Reported Date: 2024-08-01
Reported EPS: $1.05
Estimated EPS: $0.92
Surprise: +$0.13 (+14.13%)
Report Time: post-market
---

エラー処理

サーバーには、さまざまな状況に対応する包括的なエラー処理が含まれています。

  • レート制限超過
  • 無効な API キー
  • ネットワーク接続の問題
  • タイムアウト処理
  • 不正な形式のレスポンス

エラーメッセージは、人が読みやすい明確な形式で返されます。

前提条件

  • Python 3.12 以降
  • httpx
  • mcp

貢献者

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

この MCP サーバーは MIT ライセンスのもとでライセンスされています。 つまり、MIT ライセンスの利用規約に従うことを条件として、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。