Stockflow (Yahoo Finance)

🚀 StockFlow MCP 服務器

StockFlow MCP 服務器是一款模型上下文協議（MCP）服務器，藉助 Yahoo Finance 提供即時股票數據與期權分析服務。它能讓大型語言模型（LLMs）輕鬆訪問市場數據、分析股票以及評估期權策略，為金融分析提供強大支持。

🚀 快速開始

StockFlow MCP 服務器可助力大型語言模型（LLMs）訪問市場數據、分析股票並評估期權策略。以下是使用該服務器的詳細步驟：

安裝依賴項

# 安裝依賴項
pip install mcp yfinance

# 克隆倉庫
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-desktop-config.json 文件的 mcpServers 部分添加以下內容：

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

請將 "path/to/stockflow.py" 替換為你保存的 stockflow.py 文件的完整路徑。

✨ 主要特性

股票數據

• 即時獲取股票價格及關鍵指標，助你把握市場動態。
• 提供歷史價格數據及 OHLC 值，便於進行趨勢分析。
• 涵蓋公司基本面及財務報表，深入瞭解公司狀況。
• 包含市場指標和比率，為投資決策提供參考。

期權分析

• 提供完整的期權鏈數據，全面掌握期權市場。
• 計算希臘字母（delta、gamma、theta、vega），評估期權風險。
• 跟蹤成交量和未平倉頭寸，洞察市場交易情況。
• 支持期權策略分析，優化投資策略。

💻 使用示例

基礎用法

當你與 Claude 一起工作時，可以使用以下提示語來幫助它理解可用工具：

# 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": "幫我分析一下蘋果公司的股票期權。"
        }
    ],
    "model": "claude-3-opus-20240129"
}

Claude 回應：

{
    "messages": [
        {
            "role": "assistant",
            "content": "好的，請提供以下信息以進行期權分析：\n1. 期權類型（看漲或看跌）\n2. 行權價格\n3. 其他相關參數（如到期日、波動率等）。"
        }
    ]
}

📚 詳細文檔

可用工具

工具列表

• get_stock_data - 獲取股票的即時數據和歷史信息。
• get_historical_data - 分析特定時間段內的股價走勢。
• analyze_options - 評估期權策略的風險和潛在回報。

資源

提示語

• analyze_options - 進行期權策略分析，評估風險/回報，並判斷市場條件的影響。

要求

• Python 3.12+ 版本
• mcp
• yahoo-finance

侷限性

• 數據來自 Yahoo Finance，可能存在延遲。
• 期權數據的可用性取決於市場交易時間。
• 受限於 Yahoo Finance API 的速率限制。

🔧 技術細節

本項目使用 Anthropic 的模型上下文協議（MCP）構建，數據由 Yahoo Finance 提供，針對 Anthropic 的 Claude 開發。

📄 許可證

本項目採用 MIT License 授權 - 詳見 LICENSE 文件獲取詳細信息。

👨‍💻 作者

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

🙏 致謝

• 使用 Anthropic 的模型上下文協議（MCP）構建。
• 數據由 Yahoo Finance 提供。
• 針對 Anthropic 的 Claude 開發。