MCP Stock Market

🚀 MCP 株式市場

このツールは、Alpha Vantage API を通じて株式市場データを取得するためのモデルコンテキストプロトコル (MCP) ツールです。簡単な MCP インターフェースを通じて、任意の銘柄コードの日次株式市場データにアクセスできます。

🚀 クイックスタート

MCP 株式市場ツールを使用することで、Alpha Vantage API を通じて株式市場データを簡単に取得できます。以下の手順に従ってセットアップしてください。

✨ 主な機能

• Alpha Vantage API を通じて任意の銘柄コードの日次株式市場データを取得できます。
• 簡単な MCP インターフェースでアクセス可能です。

📦 インストール

必要条件

• Node.js v18 以上
• Alpha Vantage API キー（無料プランで利用可能）

インストール手順

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

   npm install
   

2. .env.example を元に .env ファイルを作成し、Alpha Vantage API キーを追加します。

   ALPHA_VANTAGE_API_KEY=your_api_key_here
   

   API キーは Alpha Vantage から無料で取得できます。

3. プロジェクトをビルドします。

   npm run build
   

💻 使用例

MCP クライアントの設定

このツールを MCP クライアントと一緒に使用するには、MCP サーバーの設定を更新してください。クライアントの設定に以下の内容を追加します。

{
  "mcpServers": {
    "stock-market": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-stock-market/build/index.js"
      ]
    }
  }
}

/ABSOLUTE/PATH/TO/PARENT/FOLDER を実際の親ディレクトリのパスに置き換えてください。

get-stock-data の使用

特定の銘柄コードの日次株式市場データを取得します。

パラメータ：

• symbol: 銘柄コード（例: IBM、AAPL、MSFT、GOOG、AMZN）

MCP クライアントでの使用例：

@stock-market get-stock-data symbol=AAPL

応答例：

株式：AAPL
最終更新日：2025-03-12
タイムゾーン：US/Eastern

日次価格：

日付：2025-03-12
始値：$178.35
高値：$180.13
安値：$177.53
終値：$179.63
出来高：58,492,206
---

日付：2025-03-11
始値：$177.99
高値：$179.70
安値：$176.86
終値：$178.95
出来高：62,630,570
---

📚 ドキュメント

開発情報

プロジェクト構造

• src/index.ts - MCP サーバーとツールの実装を含むメインアプリケーションファイル
• build/ - コンパイルされた JavaScript 出力
• .env - 環境変数（API キー）

コマンド

• npm run build - TypeScript コードをビルドします。

API 使用上の注意事項

このツールは Alpha Vantage API を使用して株式市場データを取得します。Alpha Vantage の無料プランには以下の制限があります。

• 1 日 25 回の呼び出し制限
• 1 分間 5 回の呼び出し制限

より多くの容量が必要な場合は、有料プランにアップグレードすることを検討してください。

トラブルシューティング

問題が発生した場合は、以下のことを確認してください。

1. .env ファイルに Alpha Vantage API キーが正しく設定されていること。
2. Node.js バージョン 18 以上を使用していること。
3. MCP クライアントの設定に記載されているパスが正しいこと。
4. MCP クライアントを再起動すること。