使用说明

项目简介

MCP Yahoo Finance Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务器，旨在为大型语言模型 (LLM) 应用提供实时的金融市场数据。该服务器通过集成 Yahoo Finance API，提供了一系列工具，允许 LLM 客户端查询股票价格、公司财务报表、股息信息和市场新闻等。

主要功能点

实时股票数据查询: 获取股票的当前价格。
历史股票数据查询: 查询指定日期或日期范围内的股票价格。
财务报表查询: 获取上市公司的收入报表和现金流量表。
股息信息查询: 查询股票的股息发放记录。
市场新闻: 获取与特定股票相关的最新新闻资讯。

这些功能通过标准化的 MCP 协议暴露给 LLM 客户端，使得 LLM 能够方便地调用这些工具，从而在对话或应用中融入最新的金融市场信息，提升用户体验和信息准确性。

安装步骤

使用 pip 安装 (推荐): 打开终端或命令提示符，运行以下命令即可安装：
```
pip install mcp-yahoo-finance
```

使用 Git 安装: 如果您希望从源代码安装或参与开发，可以克隆 GitHub 仓库并进行安装：

git clone [email protected]:maxscheijen/mcp-yahoo-finance.git
cd mcp-yahoo-finance
uv sync

(请确保您已安装 'uv'，uv 是一个快速的 Python 包安装和解析器。如果未安装，请参考 uv 文档)

服务器配置

MCP 服务器需要配置到 MCP 客户端才能使用。以下是针对 Claude Desktop 和 VSCode 两种常见 MCP 客户端的配置示例。您需要将以下 JSON 配置添加到您的 MCP 客户端配置文件中。

针对 Claude Desktop 客户端 (配置示例 'claude_desktop_config.json'):

{
    "mcpServers": {
        "yahoo-finance": {  // 服务器名称，可以自定义，用于在客户端中标识和引用
            "command": "uvx", // 启动服务器的命令，这里使用 uvx (uv 的执行器) 来运行 mcp-yahoo-finance
            "args": ["mcp-yahoo-finance"] // 命令参数，这里指定运行 mcp-yahoo-finance 包
        }
    }
}

针对 VSCode 客户端 (配置示例 '.vscode/mcp.json'):

{
    "servers": {
        "yahoo-finance": {  // 服务器名称，可以自定义，用于在客户端中标识和引用
            "command": "uvx", // 启动服务器的命令，这里使用 uvx (uv 的执行器) 来运行 mcp-yahoo-finance
            "args": ["mcp-yahoo-finance"] // 命令参数，这里指定运行 mcp-yahoo-finance 包
        }
    }
}

配置说明:

'"yahoo-finance"': 是您为该 MCP 服务器自定义的名称。在客户端中，您将使用这个名称来引用该服务器。
'"command": "uvx"' 和 '"args": ["mcp-yahoo-finance"]': 这两行指定了如何启动 MCP Yahoo Finance Server。 'uvx mcp-yahoo-finance' 命令会使用 'uv' 执行器来运行 'mcp-yahoo-finance' 包，从而启动服务器。如果您直接使用 'pip install mcp-yahoo-finance' 安装，并且您的 Python 环境配置正确，您也可以尝试将 '"command"' 修改为 '"mcp-yahoo-finance"'，并移除 '"args"' 字段，即： '"command": "mcp-yahoo-finance"'。具体配置取决于您的 Python 环境和包管理方式。

请注意: MCP 客户端 (如 Claude Desktop, VSCode) 会根据您提供的配置信息，自动启动和管理 MCP Yahoo Finance Server。您无需手动运行服务器，只需确保您的 MCP 客户端配置正确即可。

基本使用方法

配置完成后，您可以在支持 MCP 协议的 LLM 客户端中，通过自然语言指令来使用 Yahoo Finance 的工具。例如，您可以向 LLM 提出以下问题：

"苹果公司 (AAPL) 现在的股价是多少？"
"谷歌 (GOOG) 和苹果 (AAPL) 的股价差是多少？"
"查询 2024年1月1日到 2025年1月1日期间苹果公司 (AAPL) 的股价变化。"
"帮我获取特斯拉 (TSLA) 的最新新闻。"
"请提供微软 (MSFT) 的年度收入报表。"

LLM 客户端会将这些问题转换为对 MCP Yahoo Finance Server 工具的调用，并将结果返回给您。您无需关心底层的 API 调用和数据处理细节，只需用自然语言与 LLM 交互即可。

关键词