@qubaomingg/stock-mcp

Alpha Vantage ストック MCP サーバー

これは、Alpha Vantage APIから株式市場データを提供するモデルコンテキストプロトコル（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 コードをビルドします。

サーバーを実行します。

自動リロードを使用した開発の場合:

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

Claude for Desktop と併用

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

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

/absolute/path/to/dist/index.js 、構築された index.js ファイルへの絶対パスに置き換えます。

4. デスクトップ版のClaudeを再起動

利用可能なツール

株価データ取得

特定のシンボルの日中株価データを取得します。

パラメータ:

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

毎日の株価データを取得する

特定のシンボルの毎日の株価データを取得します。

パラメータ:

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

株価アラートを取得する

株価データを分析して、価格変動に基づいてアラートを生成します。

パラメータ:

• symbol （必須）：株式シンボル（例：IBM、AAPL）
• threshold （オプション）：価格変動アラートのしきい値（パーセント）。デフォルト：5

利用可能なリソース

株価データ

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

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

パラメータ:

• symbol : 株式シンボル（例: IBM、AAPL）
• interval : 時間間隔（毎日、1分、5分、15分、30分、60分）。デフォルト: daily

Claude での使用例:

• 「この株価データを分析できますか: stock://AAPL/daily」
• 「このデータについてどう思いますか: stock://MSFT/5min」

ライセンス

ISC