Alphavantage Stock Mcp

無料プラン向け Alpha Vantage 株価データ MCP サーバー

README の言語： English | 中文

Alpha Vantage API を通じて過去の株式市場データにアクセスするための、Model Context Protocol（MCP）サーバーの TypeScript／Node.js 実装です。このサーバーにより、LLM やエージェント型ワークフローが金融データをシームレスに利用できるようになります。

⚠️ 無料アカウント専用 この MCP サーバーは、Alpha Vantage の無料プランアカウント専用に設計されています。無料プランで利用可能な API エンドポイントのみを使用します。有料プランのエンドポイントには対応していません。

🚀 特長

• 無料プランに対応：Alpha Vantage の無料アカウントの利用制限内で動作します
• 日次株価データ：出力サイズを設定して日次時系列データにアクセスできます
• TypeScript：型定義を含む完全な TypeScript サポート
• MCP プロトコル：Claude Desktop、VS Code などの MCP 対応アプリケーションと互換性があります

📋 前提条件

• Alpha Vantage の無料 API キー

🔑 API キーの取得

1. 無料の Alpha Vantage API キーを取得します
2. MCP クライアントとの連携用に API キーをコピーします

🔌 MCP クライアントとの連携

MCP json 設定

次の json 設定を追加します：

{
  "mcpServers": {
    "alphavantage-stock-data": {  
      "command": "npx",
      "args": [
        "alphavantage-stock-mcp"
      ],
      "env": {
        "ALPHAVANTAGE_API_KEY": "YOUR-ALPHA-VANTAGE-API-KEY"
      }
    }
  }
}

🛠️ 利用可能なツール

get-stock-data

指定したシンボルと間隔で株価データを取得します。最新の 100 件のデータポイントを返します。

パラメーター：

• symbol（必須）：株式シンボル（例：「AAPL」、「GOOGL」、「MSFT」）
• interval（任意）：時間間隔。「daily」、「weekly」、「monthly」のいずれか（デフォルト：「daily」）

使用例：

Get the latest weekly data for Apple stock
Symbol: AAPL
Interval: weekly

🤝 貢献

貢献を歓迎します。次の手順に従ってください：

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

🙏 謝辞

• 株式市場データ API を提供している Alpha Vantage
• プロトコル仕様を提供している Model Context Protocol