Us Stock MCP Server

🚀 米国株式データ MCP サービス

米国株式の過去の価格データにアクセスし、更新するために設計されたモデルコンテキストプロトコル（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：株式コード

📚 ドキュメント

データ形式

保存される株式データには以下のフィールドが含まれます。

依存関係

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

注意事項

⚠️ 重要提示

更新中は重複データが自動的に処理され、最新のレコードが保持されます。

⚠️ 重要提示

頻繁な API リクエストを避けるために、5 秒の遅延が実装されています。

⚠️ 重要提示

すべてのデータ操作にはエラー処理が含まれており、サービスの安定性が確保されています。