MCP Optionsflow

🚀 選項流 MCP 服務器

選項流 MCP 服務器藉助 Yahoo Finance，為用戶提供高級選項分析和策略評估服務。它基於 Model Context Protocol (MCP)，能讓大型語言模型 (LLMs) 對期權鏈進行分析、計算 Greeks 值，還能評估基本期權策略，並給出全面的風險指標，為期權交易決策提供有力支持。

🚀 快速開始

本服務器可助力大型語言模型 (LLMs) 開展期權鏈分析、Greeks 計算以及基本期權策略評估等工作。下面為你介紹使用前的安裝和配置步驟。

✨ 主要特性

選項分析

• 能夠處理完整的期權鏈數據。
• 可計算 Greeks 值（delta、gamma、theta、vega、rho）。
• 支持隱含波動率分析。
• 能進行概率計算。
• 提供風險/收益指標。

策略分析

• 支持信用買入認購期權價差 (CCS)、保護性賣出認購期權價差 (PCS)、現金 secured puts (CSP)、覆蓋的 calls (CC) 等策略。
• 可進行位置 Greeks 評估。
• 能開展流動性分析。
• 可計算風險指標。

風險管理

• 進行報價價差分析。
• 驗證成交量和未平倉量。
• 給出倉位規模建議。
• 計算最大損失。
• 估計利潤可能性。

📦 安裝指南

# 安裝依賴項
pip install -r requirements.txt

# 克隆倉庫
git clone https://github.com/twolven/mcp-optionsflow.git
cd mcp-optionsflow

💻 使用示例

基礎用法

將以下內容添加到您的 Claude 配置中： 在 claude-desktop-config.json 文件的 mcpServers 部分添加以下內容：

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

將 path/to/optionsflow.py 替換為您保存的 optionsflow.py 文件的完整路徑。

高級用法

可用工具

analyze_basic_strategies 工具的輸入參數格式如下：

{
    "symbol": str,                    # 必需：股票代碼
    "strategy": str,                  # 必需："ccs", "pcs", "csp", 或 "cc"
    "expiration_date": str,          # 必需："YYYY-MM-DD"
    "delta_target": float,           # 可選：CSP/CC 的目標 delta（默認值：0.3）
    "width_pct": float              # 可選：價差寬度（默認值：0.05）
}

策略分析響應格式

{
    "symbol": str,
    "strategy": str,
    "current_price": float,
    "expiration": str,
    "days_to_expiration": int,
    "analysis": {
        # 信用買入認購期權價差 / 保護性賣出認購期權價差
        "strikes": {
            "short_strike": float,
            "long_strike": float
        },
        # 其他分析指標...
    },
    # 其他響應數據...
}

示例

調用 analyze_basic_strategies 工具的示例：

{
    "symbol": "MSFT",
    "strategy": "ccs",
    "expiration_date": "2024-01-31",
    "delta_target": 0.5,
    "width_pct": 0.1
}

📚 詳細文檔

注意事項

• 數據來源為 Yahoo Finance，可能會存在延遲或不準確的情況。
• 策略分析基於假設的 Greeks 計算和 Black-Scholes 模型。
• 工具提供詳細的響應格式，方便用戶解析和使用結果數據。

貢獻者

歡迎有興趣的開發者貢獻代碼，共同改進和完善此項目。