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