AlphaVantage MCP Server

AlphaVantage MCP サーバー

これは、AlphaVantage の金融データ API サービスとの統合を目的に、MCP（Model Control Protocol）フレームワークに基づいて構築されたサーバーです。AlphaVantage の詳細については、こちらをご覧ください。

プロジェクトの概要

AlphaVantage は、次のようなリアルタイムおよび過去の金融市場データを提供する API サービスです。

• 株式市場データ
• 外国為替データ
• 暗号資産データ
• テクニカル指標
• ファンダメンタルデータ

このプロジェクトでは、AlphaVantage の機能を MCP サービスとしてカプセル化し、他のアプリケーションと簡単に統合できるようにしています。

MCP サーバーのインストール

Smithery を使用したインストール

Smithery を使用して、Claude Desktop 用の AlphaVantage MCP サーバーを自動的にインストールするには、次の手順に従ってください。

npx -y @smithery/cli install @lifejwang11/alphavantage-mcp

前提条件

• Python 3.12
• pip パッケージマネージャー

インストール手順

1. プロジェクトをクローンします

git clone https://github.com/lifejwang11/alphavantage-mcp
cd alphavantage-mcp

2. 仮想環境を作成して有効化します（推奨）

python -m venv venv
source venv/bin/activate  # Unix/macOS
# or
.\venv\Scripts\activate  # Windows

3. 依存関係をインストールします

pip install -r requirements.txt

4. 環境変数を設定します

export ALPHAVANTAGE_API_KEY=your_api_key

5. サーバーを起動します

python main.py

AlphaVantage の機能

この MCP サーバーは、次の AlphaVantage の主要機能に対応しています。

1. 株式市場データ

   • リアルタイムの株価
   • 過去の価格データ
   • 企業情報

2. テクニカル指標

   • 移動平均
   • RSI
   • MACD など

3. ファンダメンタルデータ

   • 財務諸表
   • 決算報告
   • 企業概要

使用ガイド

1. AlphaVantage API キーを取得します

   • AlphaVantage のウェブサイトにアクセスします
   • 登録して API キーを取得します

2. API キーを設定します

   • 環境変数に ALPHAVANTAGE_API_KEY を設定します
   • または、設定ファイルで設定します

3. サービスを呼び出します

   • MCP プロトコルを通じて呼び出します
   • 詳細なインターフェース仕様については、API ドキュメントを参照してください

重要な注意事項

• API のレート制限については、AlphaVantage の公式ドキュメントを参照してください
• 本番環境では、より高いレート制限を利用できるプレミアム API キーを推奨します
• API キーは安全に取り扱い、公開コードに決して含めないでください

貢献

プロジェクトの改善に役立つ Issue や Pull Request を歓迎します。

ライセンス

MIT ライセンス

Copyright (c) 2025 lifejwang11

本ソフトウェアおよび関連するドキュメントファイル（以下「ソフトウェア」）の複製を取得するすべての人に対し、ソフトウェアを無制限に取り扱うことを無償で許可します。これには、使用、複製、変更、結合、公開、配布、サブライセンス、および／または販売する権利が含まれます。また、ソフトウェアを提供された人に同様の権利を許可することも認められます。ただし、次の条件に従うものとします。

上記の著作権表示および本許諾表示は、ソフトウェアのすべての複製または実質的な部分に含めるものとします。

本ソフトウェアは「現状のまま」提供され、明示または黙示を問わず、いかなる種類の保証もありません。これには、商品性、特定目的への適合性、および権利非侵害の保証が含まれますが、これらに限定されません。作者または著作権者は、契約、不法行為、その他の行為に基づくかを問わず、本ソフトウェアまたはその使用、その他の取り扱いに起因または関連して発生するあらゆる請求、損害、その他の責任について、一切責任を負いません。