MCP Stock Market

MCP 株式市場

Alpha Vantage API を使用して株式市場データを取得する Model Context Protocol（MCP）ツールです。シンプルな 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

応答例：

Stock: AAPL
Last Updated: 2025-03-12
Time Zone: US/Eastern

Daily Prices:

Date: 2025-03-12
Open: $178.35
High: $180.13
Low: $177.53
Close: $179.63
Volume: 58,492,206
---

Date: 2025-03-11
Open: $177.99
High: $179.70
Low: $176.86
Close: $178.95
Volume: 62,630,570
---

開発

プロジェクト構成

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

コマンド

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

API の使用に関する注意事項

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

• 1 日あたり 25 回の API 呼び出し
• 1 分あたり 5 回の API 呼び出し

より多くの利用枠が必要な場合は、プレミアムプランへのアップグレードをご検討ください。

トラブルシューティング

問題が発生した場合：

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