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>"
}
}
}
}
パッケージをインストールする
ランニング
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 `
利用可能なツール
サーバーは 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キー
- ネットワーク接続の問題
- タイムアウト処理
- 不正な応答
エラー メッセージは、明確で人間が読める形式で返されます。
前提条件
寄稿者
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。
ライセンス
このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。