Alpha Vantage Stock Analysis MCP Server

🚀 Alpha Vantage株式MCPサーバー

このサーバーは、Alpha Vantage APIを使用して株式市場データを提供するModel Context Protocol (MCP) サーバーです。Claudeやその他のMCPクライアントが、リアルタイムおよび過去の株式データにアクセスできるようになります。

✨ 主な機能

• カスタマイズ可能な間隔での盤中株式データの取得
• 日次株式データの取得
• 価格変動に基づく株式アラートの生成
• リソースとしての株式データへのアクセス

📦 インストール

前提条件

• Node.js 16以上
• Alpha Vantage APIキー（無料で取得できます：Alpha Vantage）

インストール手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. プロジェクトのルートディレクトリに.envファイルを作成し、Alpha Vantage APIキーを追加します。

   ALPHA_VANTAGE_API_KEY=your_api_key_here
   

ビルドと実行

TypeScriptコードをビルドします。

npm run build

サーバーを起動します。

npm start

開発環境で自動再起動を使用する場合は、以下を実行します。

npm run dev

APIクライアントをテストします。

npm test

💻 使用例

Claudeデスクトップ版との連携

このMCPサーバーをClaudeデスクトップ版と連携するには、以下の手順を実行します。

1. Claudeデスクトップ版を開きます。
2. 設定 > 開発者 > 設定の編集に移動します。
3. claude_desktop_config.jsonに以下の内容を追加します。

{
  "mcpServers": {
    "alpha-vantage": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "YOUR_API_KEY"
      } 
    }
  }
}

/absolute/path/to/dist/index.jsを、実際にビルドされたindex.jsファイルの絶対パスに置き換えます。 4. Claudeデスクトップ版を再起動します。

利用可能なツール

get-stock-data

特定の株式の盤中データを取得します。

• symbol（必須）：株式コード（例：IBM、AAPL）
• interval（オプション）：データポイント間の時間間隔（1min、5min、15min、30min、60min）。デフォルト：5min
• outputsize（オプション）：返されるデータ量（compact：最新の100個のデータポイント、full：最大20年分のデータ）。デフォルト：compact

get-daily-stock-data

特定の株式の日次データを取得します。

• symbol（必須）：株式コード（例：IBM、AAPL）
• outputsize（オプション）：返されるデータ量（compact：最新の100個のデータポイント、full：最大20年分のデータ）。デフォルト：compact

get-stock-alerts

株式データを分析し、価格変動アラートを生成します。

• symbol（必須）：株式コード（例：IBM、AAPL）
• interval（オプション）：監視間隔。デフォルト：5min
• threshold（オプション）：変動閾値のパーセント。デフォルト：2%

利用可能なリソース

株式データリソース

以下のURI形式で株式データにアクセスできます。

stock://<symbol>[?<interval>&<outputsize>]

• symbol：株式コード
• interval（オプション）：データ間隔、デフォルトは5min
• outputsize（オプション）：出力サイズ、compactまたはfull

例

AAPLの日次データを取得する場合：

stock://AAPL?interval=1day&outputsize=full

📄 ライセンス

[ここにライセンス情報を挿入]