StockFlow MCPサーバー

Yahoo Financeを通じてリアルタイムの株式データとオプション分析を提供するモデルコンテキストプロトコル（MCP）サーバー。LLM（法務・法務・法務）が市場データにアクセスし、株式を分析し、オプション戦略を評価できるようにします。

特徴

株価データ

リアルタイムの株価と主要指標
OHLC値を含む過去の価格データ
企業の基礎情報と財務諸表
市場指標と比率

オプション分析

完全なオプションチェーンデータ
ギリシャ文字（デルタ、ガンマ、シータ、ベガ）
取引量と未決済建玉の追跡
オプション戦略分析

インストール

# Install dependencies
pip install mcp yfinance

# Clone the repository
git clone https://github.com/twolven/stockflow
cd stockflow

使用法

リポジトリをクローンします。

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

依存関係をインストールします:

pip install -r requirements.txt

Claude 構成に追加します。claude claude-desktop-config.jsonで、 mcpServersセクションに以下を追加します。

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

「path/to/stockflow.py」を、stockflow.py ファイルを保存した場所へのフルパスに置き換えます。

クロードの使用プロンプト

Claude を操作するときは、次のプロンプトを使用して、使用可能なツールを理解できるようにすることができます。

株式市場データにアクセスできるストックフローツールを有効にしました。以下の3つの主な機能をご利用いただけます。

get_stock_data - 包括的な株価情報を取得します:

{
    "symbol": "AAPL",
    "include_financials": true,  # optional
    "include_analysis": true,    # optional
    "include_calendar": true     # optional
}

get_historical_data - 価格履歴とテクニカル指標を取得します。

{
    "symbol": "AAPL",
    "period": "1y",        # 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
    "interval": "1d",      # 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
    "prepost": false       # optional - include pre/post market data
}

get_options_chain - オプションデータを取得します:

{
    "symbol": "AAPL",
    "expiration_date": "2024-12-20",  # optional - uses nearest date if not specified
    "include_greeks": true            # optional
}

すべての応答には、現在の価格データ、エラー処理、包括的な市場情報が含まれます。

サーバーの実行

python stockflow.py

MCPクライアントでの使用

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["stockflow.py"]
)

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # Get current stock data
            result = await session.call_tool(
                "get-stock-data", 
                arguments={"symbol": "AAPL"}
            )
            
            # Get options chain
            options = await session.call_tool(
                "get-options-chain",
                arguments={
                    "symbol": "AAPL",
                    "expiration_date": "2024-12-20"
                }
            )

if __name__ == "__main__":
    import asyncio
    asyncio.run(run())

利用可能なツール

get-stock-data
- 現在の価格と数量
- 時価総額とPER
- 52週間の高値/安値
get-historical-data
- OHLC価格
- 設定可能な期間
- ボリュームデータ
get-options-chain
- コールとプット
- 行使価格
- ギリシャ人とIV
- 取引量と未決済建玉

利用可能なリソース

company-info://{symbol}
- 会社概要
- セクターと業界
- 従業員数
- Webサイト
financials://{symbol}
- 損益計算書
- 貸借対照表
- キャッシュフロー計算書

プロンプト

analyze-options
- オプション戦略分析
- リスクと報酬の評価
- 市場状況の評価

要件

Python 3.12以上
マクピー
yファイナンス

制限事項

データはYahoo Financeから取得されており、遅延が生じる可能性があります。
オプションデータの利用可能時間は市場時間によって異なります
Yahoo Finance APIの制限に基づいてレート制限が適用されます

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

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

著者

トッド・ウルブン - ( https://github.com/twolven )

謝辞

Anthropicのモデルコンテキストプロトコル（MCP）を使用して構築
データはYahoo Financeより提供
アントロピックのクロードとの使用のために開発されました

StockFlow MCP Server

Integrations