@qubaomingg/stock-mcp

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 for Desktop での使用

この MCP サーバーを Claude for Desktop で使用するには：

1. Claude for Desktop を開きます
2. Settings > Developer > Edit Config に移動します
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 for Desktop を再起動します

利用可能なツール

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）
• threshold（任意）：株価変動アラートのしきい値（パーセント）。デフォルト：5

利用可能なリソース

stock-data

リソースとして株式データに直接アクセスします。

URI テンプレート：stock://{symbol}/{interval}

パラメーター：

• symbol：銘柄シンボル（例：IBM、AAPL）
• interval：時間間隔（daily、1min、5min、15min、30min、60min）。デフォルト：daily

Claude での使用例：

• 「この株式データを分析してくれますか：stock://AAPL/daily」
• 「このデータについてどう思いますか：stock://MSFT/5min」

ライセンス

ISC