AlphaVantage-MCP
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.jsonWindows の場合:
%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 toolsget-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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Financial Modeling Prep API with 250+ financial data tools
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis is an MCP server that provides access to the Alpha Vantage API, allowing stock data retrieval to be used as context to LLMs.29MIT
- AlicenseCqualityDmaintenanceA 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.941Apache 2.0
- AlicenseAqualityDmaintenanceA minimal MCP server that provides stock snapshots including company metadata, latest quote, fundamentals, and daily price history via the Alpha Vantage API.1MIT
- FlicenseNot gradedqualityDmaintenanceA 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.-