US Stock Data MCP Server

米国株式データ MCP サーバー

米国株式の過去の株価データにアクセスして更新するために設計された、Model Context Protocol（MCP）サーバーです。

機能

• ローカルデータストレージ：株式データを CSV 形式でローカルに保存し、すばやくアクセスできます
• 自動更新：Yahoo Finance から株式データを自動更新できます
• 安全なデータ書き込み：一時ファイルを使用して、アトミックかつ安全にデータを書き込みます
• 柔軟な期間指定：データ更新の開始日をカスタマイズできます

インストール

1. Python 3.x がインストールされていることを確認します
2. このリポジトリをクローンします
3. 依存関係をインストールします：

pip install -r requirements.txt

使用方法

1. サーバーを起動する

python server.py

サーバー起動後のデフォルトのデータ保存先は ~/Library/Application Support/us-market-data/data です。

US_STOCK_DATA_DIR 環境変数を使用して、データの保存先をカスタマイズできます。

2. 利用可能な機能

MCP ツール

1. get_local_stock_data

   • 機能：ローカルの株式過去データを取得します
   • パラメーター：
     • symbol：株式ティッカー。例：'AAPL'、'MSFT'

2. update_stock_data

   • 機能：株式データを更新します
   • パラメーター：
     • symbol：株式ティッカー。例：'AAPL'、'MSFT'
     • start_date：YYYY-MM-DD 形式の開始日。デフォルトは 2015-01-01 です

MCP リソース

• リソース URI：usstock://{symbol}/historical
  • 機能：米国株式の過去の株価データをローカルで提供します
  • パラメーター：
    • symbol：株式ティッカー

データ形式

保存される株式データには、次のフィールドが含まれます：

• Date：取引日
• Open：始値
• High：高値
• Low：安値
• Close：終値
• Volume：取引高

依存関係

• mcp：MCP プロトコルの実装
• pandas：データ処理と分析
• yfinance：Yahoo Finance からのデータ取得
• pydantic：データ検証と設定管理

注意事項

1. 更新時には重複データが自動的に処理され、最新のレコードが保持されます
2. API リクエストの頻発を避けるため、更新処理の間に 5 秒の遅延を設けています
3. サービスの安定性を確保するため、すべてのデータ操作にエラー処理を実装しています