Stockflow (Yahoo Finance)

🚀 StockFlow MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を用いて、Yahoo Financeからリアルタイムの株式データとオプション分析を提供します。大型言語モデル（LLMs）が市場データにアクセスし、株式を分析し、オプション戦略を評価できるようにします。

✨ 主な機能

株式データ

• リアルタイムの株価と主要指標
• 過去の価格データとOHLC値
• 会社の基本情報と財務報告
• 市場指標と比率

オプション分析

• 完全なオプションチェーンデータ
• ギリシャ文字（デルタ、ガンマ、シータ、ベガ）
• 出来高と建玉数の追跡
• オプション戦略分析

📦 インストール

# 依存関係のインストール
pip install mcp yfinance

# リポジトリのクローン
git clone https://github.com/twolven/stockflow
cd stockflow

💻 使用例

基本的な使用法

1. リポジトリのクローン：

git clone https://github.com/twolven/mcp-stockflow.git
cd mcp-stockflow

2. 依存関係のインストール：

pip install -r requirements.txt

3. Claude設定への追加： claude-desktop-config.json ファイルの mcpServers セクションに以下の内容を追加します。

{
    "mcpServers": {
        "stockflow": {
            "command": "python",
            "args": ["path/to/stockflow.py"]
        }
    }
}

"path/to/stockflow.py" を保存した stockflow.py ファイルの完全パスに置き換えてください。

高度な使用法

Claudeと一緒に作業する際には、以下のプロンプトを使用して、利用可能なツールをClaudeに理解させることができます。

“株式データツールを有効にしています。これらのツールを使用すると、株式市場データにアクセスできます。主な3つの機能を利用できます。

1. get_stock_data - 包括的な株式情報の取得：

{
    "symbol": "AAPL",
    "include_financials": true,  # オプションパラメータ
    "include_analysis": true,    # オプションパラメータ
    "include_calendar": true     # オプションパラメータ
}

2. get_historical_data - 価格の歴史とテクニカル指標の取得：

{
    "symbol": "AAPL",
    "start_date": "2024-01-01",  # 開始日
    "end_date": "2024-12-31"     # 終了日
}

3. analyze_options - オプション分析の実行：

{
    "symbol": "AAPL",
    "option_type": "call",  # オプション：call（コール）または put（プット）
    "strike_price": 150      # 行使価格
}

サンプル会話

ユーザー入力：

{
    "messages": [
        {
            "role": "user",
            "content": "Appleの株式オプションを分析してください。"
        }
    ],
    "model": "claude-3-opus-20240129"
}

Claudeの応答：

{
    "messages": [
        {
            "role": "assistant",
            "content": "了解しました。オプション分析を行うために以下の情報を提供してください。\n1. オプションの種類（コールまたはプット）\n2. 行使価格\n3. その他の関連パラメータ（満期日、ボラティリティなど）。"
        }
    ]
}

📚 ドキュメント

利用可能なツール

ツールリスト

• get_stock_data - 株式のリアルタイムデータと過去の情報を取得します。
• get_historical_data - 特定の期間の株価の動きを分析します。
• analyze_options - オプション戦略のリスクと潜在的な収益を評価します。

リソース

プロンプト

1. analyze_options - オプション戦略の分析を行い、リスク/収益を評価し、市場条件の影響を判断します。

要件

• Python 3.12以上のバージョン
• mcp
• yahoo-finance

制限事項

• データはYahoo Financeから取得されるため、遅延が発生する可能性があります。
• オプションデータの可用性は市場の取引時間に依存します。
• Yahoo Finance APIのレート制限による制約があります。

貢献

貢献を歓迎します！自由にPull Requestを送信してください。

📄 ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています - 詳細は LICENSE ファイルを参照してください。

作者

Todd Wolven - (https://github.com/twolven)

謝辞

• Anthropicのモデルコンテキストプロトコル（MCP）を使用して構築されています。
• データは Yahoo Finance から提供されています。
• AnthropicのClaude向けに開発されています。