项目简介

Yahoo Finance MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为大型语言模型 (LLM) 提供全面的金融数据访问能力。该服务器集成了 Yahoo Finance API，允许用户通过 LLM 客户端（如 Claude）便捷地获取股票、财务报表、期权等 разнообразные 金融信息，从而支持 LLM 在金融分析、市场研究和投资决策等领域的应用。

主要功能点

股票信息查询: 获取股票的实时价格、公司信息、关键指标等详细数据。
历史价格数据: 查询股票在指定时间段内的历史价格（开盘价、最高价、最低价、收盘价、成交量等）。
财经新闻: 获取与特定股票相关的最新财经新闻报道。
财务报表: 获取上市公司的年度或季度财务报表，包括利润表、资产负债表和现金流量表。
股东信息: 查询主要股东、机构股东、共同基金以及内部交易等股东信息。
期权数据: 获取股票的期权到期日和期权链数据（认购期权和认沽期权）。
分析师评级: 获取分析师对股票的评级和目标价格等建议。

安装步骤

克隆仓库:

git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
cd yahoo-finance-mcp

创建并激活虚拟环境，安装依赖:

uv venv
source .venv/bin/activate  # 在 Windows 系统上使用: .venv\Scripts\activate
uv pip install -e .

服务器配置

要将此 MCP 服务器与 MCP 客户端（例如 Claude for Desktop）集成，您需要配置客户端以连接到此服务器。以下是 Claude for Desktop 的配置示例，您需要编辑 'claude_desktop_config.json' 文件，添加 'yfinance' 服务器配置：

{
  "mcpServers": {
    "yfinance": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

配置参数说明:

server name: 'yfinance' (服务器名称，客户端用此名称识别和调用)
command: 'uv' (启动服务器的命令，这里使用 'uv run' 运行 'server.py' 文件)
args: 启动命令的参数，包括：
- '--directory': '/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp' (指向 'yahoo-finance-mcp' 仓库父目录的绝对路径，请替换为您的实际路径)
- 'run': uv 的 'run' 子命令，用于运行 Python 脚本
- 'server.py': 服务器主程序文件

注意:

您需要将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp' 替换为您本地 'yahoo-finance-mcp' 仓库父目录的绝对路径。例如，如果您的仓库位于 '/Users/yourusername/Documents/yahoo-finance-mcp'，则父目录路径为 '/Users/yourusername/Documents'。
如果 'uv' 命令不在您的系统 PATH 环境变量中，您可能需要提供 'uv' 可执行文件的完整路径。可以使用 'which uv' (macOS/Linux) 或 'where uv' (Windows) 命令查找 'uv' 的路径。

配置完成后，重启 Claude for Desktop 客户端，即可连接到 Yahoo Finance MCP Server。

基本使用方法

配置并启动服务器后，您可以在支持 MCP 协议的 LLM 客户端中使用自然语言指令来调用服务器提供的工具。例如，在 Claude 中，您可以这样提问：

"获取苹果公司 (AAPL) 过去6个月的每日股价"
"查询微软 (MSFT) 的季度资产负债表"
"分析特斯拉 (TSLA) 的最新财经新闻"
"显示标普500指数 (SPY) 2024年6月21日到期的认购期权链"
"最近三个月亚马逊 (AMZN) 的分析师评级有哪些变化？"

LLM 客户端会将您的自然语言指令转换为对 MCP 服务器特定工具的调用，并返回结构化的金融数据结果，供 LLM 进行后续分析和处理。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息