Alpha Vantage MCP Server

Alpha Vantage MCP サーバー

Alpha Vantage API のさまざまなエンドポイントを MCP ツールとして公開する Model Context Protocol（MCP）サーバーです。株式の基本データ、オプション、インテリジェンス、ファンダメンタルデータ、テクニカル指標などの金融データにアクセスできます。このサーバーにより、Alpha Vantage のデータを MCP 対応のエージェントやシステムに簡単に統合できます。

前提条件

• Node.js（v18 以降を推奨）
• npm（Node.js に付属）
• Alpha Vantage API キー
• （任意）MCP 対応クライアントまたはランナー（例：VSCode 拡張機能、CLI）

セットアップ

1. リポジトリをクローンするか、プロジェクトディレクトリにいることを確認してください。

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

   npm install
   

3. 設定：

   • https://www.alphavantage.co/ から Alpha Vantage API キーを取得します。
   • MCP ランナーの設定で ALPHAVANTAGE_API_KEY 環境変数を設定します。これは、MCP クライアントとスムーズに統合するために推奨される方法です。MCP ランナー経由で実行する場合は、この用途に .env ファイルを使用しないでください。

ビルドと実行

1. サーバーをビルドします。

   npm run build
   

   コンパイル済みの JavaScript コードを含む build ディレクトリが作成されます。

2. サーバーを実行します。

   npm run start
   

   または、直接実行します。

   node build/index.js
   

3. MCP ランナー経由で実行する場合： stdio トランスポートを使用してサーバーを実行するよう、MCP クライアントを設定します。 MCP 設定の例（/path/to/mcp-alphavantage を実際のパスに変更し、YOUR_API_KEY_HERE を実際のキーに置き換えてください）：

   "alphavantage": {
     "transportType": "stdio",
     "command": "node",
     "args": [
       "/path/to/mcp-alphavantage/build/index.js"
     ],
     "env": {
       "ALPHAVANTAGE_API_KEY": "YOUR_API_KEY_HERE"
     }
     // ... other optional settings ...
   }
   

利用可能なツール

サーバーは Alpha Vantage API のエンドポイントを、機能別に分類された個別の MCP ツールとして公開します。

• 株式の基本データ
• オプションデータ
• Alpha Intelligence
• ファンダメンタルデータ
• テクニカル指標
• 外国為替
• 暗号通貨
• コモディティ
• 経済指標

各ツールの入力スキーマと説明は、サーバーに接続した MCP エージェントがイントロスペクションを通じて自動的に確認できます。

プロジェクト構成

プロジェクトはモジュール式の構成になっています。

.
├── src/
│   ├── index.ts          # Server entry point
│   └── tools/
│       ├── index.ts      # Registers all tool categories
│       ├── fundamentals/ # Fundamental Data tools
│       │   └── ...
│       ├── indicators/   # Technical Indicators tools
│       │   └── ...
│       ├── intelligence/ # Alpha Intelligence tools
│       │   └── ...
│       ├── options/      # Options Data tools
│       │   └── ...
│       ├── stocks/       # Core Stocks tools
│       │   └── ...
│       ├── forex/        # Forex tools
│       │   └── ...
│       ├── crypto/       # Cryptocurrency tools
│       │   └── ...
│       ├── commodities/  # Commodities tools
│       │   └── ...
│       └── economic/     # Economic Indicators tools
│           └── ...
├── memory-bank/          # Project documentation
│   └── ...
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
├── eslint.config.js      # ESLint configuration
├── .prettierrc           # Prettier configuration
├── LICENSE               # Project license
└── README.md             # This file

キャッシュ

サーバーは、ツールの応答に対してインメモリの Least Recently Used（LRU）キャッシュを実装しています。これにより、Alpha Vantage API への重複した呼び出しを減らし、パフォーマンスを向上させるとともに、レート制限に準拠できます。

• 仕組み： キャッシュはツール名と入力パラメーターに基づいて応答を保存します。
• 設定可能な TTL： 各ツールには、キャッシュされたデータの Time To Live（TTL）を設定できます。設定は src/cacheConfig.ts で定義されています。これにより、各 Alpha Vantage エンドポイントが提供するデータの更新頻度に応じて、キャッシュ期間を変えられます。

ライセンス

このプロジェクトは、Free Software Foundation が公開する GNU General Public License（バージョン 3、または任意でそれ以降のバージョン）のもとでライセンスされています。詳細は LICENSE ファイルを参照してください。

貢献

貢献を歓迎します。標準的なフォークとプルリクエストのワークフローに従ってください。

サポート

問題や質問がある場合は、GitHub リポジトリで issue を作成してください。