StockFlow MCP 服务器

模型上下文协议 (MCP) 服务器通过雅虎财经提供实时股票数据和期权分析。使法学硕士 (LLM) 能够访问市场数据、分析股票并评估期权策略。

特征

股票数据

实时股票价格和关键指标
具有 OHLC 值的历史价格数据
公司基本面和财务报表
市场指标和比率

期权分析

完整的期权链数据
希腊字母（delta、gamma、theta、vega）
交易量和未平仓合约跟踪
期权策略分析

安装

# Install dependencies
pip install mcp yfinance

# Clone the repository
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 文件的完整路径。

克劳德的使用提示

使用 Claude 时，您可以使用此提示来帮助它了解可用的工具：

我已启用 Stockflow 工具，您可以访问股票市场数据。您可以使用以下三个主要功能：

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

{
    "symbol": "AAPL",
    "include_financials": true,  # optional
    "include_analysis": true,    # optional
    "include_calendar": true     # optional
}

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

{
    "symbol": "AAPL",
    "period": "1y",        # 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
    "interval": "1d",      # 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo
    "prepost": false       # optional - include pre/post market data
}

get_options_chain - 获取选项数据：

{
    "symbol": "AAPL",
    "expiration_date": "2024-12-20",  # optional - uses nearest date if not specified
    "include_greeks": true            # optional
}

所有回复都包括当前价格数据、错误处理和全面的市场信息。”

运行服务器

python stockflow.py

与 MCP 客户端一起使用

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

server_params = StdioServerParameters(
    command="python",
    args=["stockflow.py"]
)

async def run():
    async with stdio_client(server_params) as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            
            # Get current stock data
            result = await session.call_tool(
                "get-stock-data", 
                arguments={"symbol": "AAPL"}
            )
            
            # Get options chain
            options = await session.call_tool(
                "get-options-chain",
                arguments={
                    "symbol": "AAPL",
                    "expiration_date": "2024-12-20"
                }
            )

if __name__ == "__main__":
    import asyncio
    asyncio.run(run())

可用工具

get-stock-data
- 当前价格和数量
- 市值和市盈率
- 52周最高/最低
get-historical-data
- OHLC价格
- 可配置的时间段
- 体积数据
get-options-chain
- 看涨期权和看跌期权
- 执行价格
- 希腊人和 IV
- 交易量和未平仓合约

可用资源

company-info://{symbol}
- 公司描述
- 行业和部门
- 员工人数
- 网站
financials://{symbol}
- 损益表
- 资产负债表
- 现金流量表

提示

analyze-options
- 期权策略分析
- 风险/回报评估
- 市场状况评估

要求

Python 3.12+
甲基氯丙烯
yfinance

限制

数据来源于雅虎财经，可能会有延迟
期权数据的可用性取决于市场时间
根据 Yahoo Finance API 限制应用速率限制

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

作者

托德·沃尔文 - ( https://github.com/tolven )

致谢

使用 Anthropic 的模型上下文协议 (MCP) 构建
数据由雅虎财经提供
专为与 Anthropic 的 Claude 配合使用而开发

StockFlow MCP Server

Integrations