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一起工作时，可以使用以下提示语来帮助它理解可用工具：

“我已经启用了股票数据工具，这些工具让你能够访问到股票市场数据。你可以使用这三个主要功能：

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 - 评估期权策略的风险和潜在回报。

资源

提示语

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开发