JinDaGe - Stockflow (Yahoo Finance) MCP Details

article

README

🚀 StockFlow MCP 服务器

StockFlow MCP 服务器是一款基于模型上下文协议（MCP）的服务器，借助 Yahoo Finance 提供实时股票数据与期权分析服务。它能让大型语言模型（LLMs）轻松访问市场数据、分析股票以及评估期权策略，为金融分析与决策提供有力支持。

✨ 主要特性

股票数据

📈 实时获取股票价格及关键指标，把握市场动态。
📊 提供历史价格数据及 OHLC 值，助力深入分析。
📄 呈现公司基本面及财务报表，洞察企业状况。
📋 涵盖市场指标和比率，全面评估市场形势。

期权分析

🔍 提供完整的期权链数据，掌握期权全貌。
📉 计算希腊字母（delta、gamma、theta、vega），量化风险。
📊 跟踪成交量和未平仓头寸，了解市场热度。
📈 进行期权策略分析，优化投资决策。

📦 安装指南

# 安装依赖项
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 一起工作时，可以使用以下提示语来帮助它理解可用工具： “我已经启用了股票数据工具，这些工具让你能够访问到股票市场数据。你可以使用这三个主要功能：

get_stock_data - 获取全面的股票信息：

{
    "symbol": "AAPL",
    "include_financials": true,  # 可选参数
    "include_analysis": true,    # 可选参数
    "include_calendar": true     # 可选参数
}

get_historical_data - 获取价格历史和技术指标：

{
    "symbol": "AAPL",
    "start_date": "2024-01-01",  # 起始日期
    "end_date": "2024-12-31"     # 结束日期
}

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 的速率限制。

贡献

欢迎贡献！请随意提交 Pull Request。

许可证

本项目采用 MIT License 授权 - 详见 LICENSE 文件获取详细信息。

作者

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

致谢

使用 Anthropic 的模型上下文协议（MCP）构建。
数据由 Yahoo Finance 提供。
针对 Anthropic 的 Claude 开发。

Stockflow (Yahoo Finance)