Stockflow MCP 服务器使用说明

项目简介

Stockflow MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型 (LLM) 提供实时的股票市场数据和期权分析能力。通过集成 Yahoo Finance API，该服务器能够让 LLM 访问股票价格、公司财务信息、历史数据以及期权链数据，从而增强 LLM 在金融分析和投资决策方面的能力。

主要功能点

实时股票数据: 获取股票的实时价格、关键指标和公司基本面信息，例如股票代码、公司名称、行业板块、公司描述、实时价格、市值、市盈率等。
历史价格数据: 提供股票的历史价格数据，包括 OHLC（开盘价、最高价、最低价、收盘价）数据和成交量，并支持多种时间周期和技术指标（如均线、MACD、RSI）。
期权链数据: 获取完整的期权链数据，包括看涨期权和看跌期权，以及 Greeks 值（Delta, Gamma, Theta, Vega）等高级信息，帮助分析期权策略。
财务数据和分析: 可选获取公司的季度财务报表、分析师评级和盈利预测等深入数据。

安装步骤

环境准备: 确保您的系统已安装 Python 3.12 或更高版本。

克隆仓库: 将 Stockflow 仓库克隆到本地：

git clone https://github.com/twolven/mcp-stockflow.git
cd mcp-stockflow

安装依赖: 使用 pip 安装项目所需的 Python 库：

pip install -r requirements.txt

服务器配置

要将 Stockflow MCP 服务器配置到 MCP 客户端（例如 Claude），您需要在客户端的配置文件中添加 Stockflow 服务器的启动信息。通常，配置文件是 JSON 格式。以下是一个配置示例，您需要根据实际情况修改 'args' 中的 'stockflow.py' 路径：

{
    "mcpServers": {
        "stockflow": {
            "command": "python",
            "args": ["/path/to/mcp-stockflow/stockflow.py"]  // 将 "/path/to/mcp-stockflow/stockflow.py" 替换为 stockflow.py 文件的实际路径
        }
    }
}

注意:

请将 '/path/to/mcp-stockflow/stockflow.py' 替换为您本地 'stockflow.py' 文件的绝对路径。您可以使用 'pwd' 命令在仓库目录下执行来获取当前目录的绝对路径，然后拼接上 'stockflow.py'。
'server name' 为 'stockflow'，在客户端中引用该服务器时会用到。

基本使用方法

启动服务器: 在 Stockflow 仓库目录下，打开终端并执行以下命令来启动 MCP 服务器：
```
python stockflow.py
```
服务器成功启动后，将开始监听 MCP 客户端的请求。
客户端调用: 在您的 MCP 客户端（如 Claude）中，即可通过配置的 'server name' (stockflow) 调用 Stockflow 服务器提供的工具来获取股票数据。例如，您可以指示 Claude 使用 'get_stock_data_v2' 工具查询苹果公司 (AAPL) 的股票信息。

具体可用的工具名称和参数，请参考仓库 README.md 或 'stockflow.py' 文件中 '@app.list_tools()' 函数的定义。常用的工具包括 'get_stock_data_v2' (获取股票数据), 'get_historical_data_v2' (获取历史数据), 'get_options_chain_v2' (获取期权链数据)。

在与 LLM 对话时，您可以自然语言描述您的需求，或者使用更结构化的 JSON 格式来精确调用工具。

关键词