使用说明

项目简介

本项目 'yfinance MCP Server' 是一个实现了 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型（LLM）客户端提供实时的金融市场数据。它利用 'yfinance' 库访问 Yahoo Finance API，并将股票信息、历史数据等资源和工具以标准化的 MCP 协议形式暴露给客户端，例如 Claude Desktop。用户可以通过 Claude Desktop 等 MCP 客户端配置并连接到此服务器，从而在与 LLM 对话时，能够查询和利用最新的金融数据。

主要功能点

资源 (Resources): 提供股票信息资源，允许客户端获取指定股票的实时数据快照。
工具 (Tools): 提供以下工具供客户端调用，以执行更具体的数据查询：
- 'get_stock_metric': 获取指定股票的特定指标数据，例如当前价格、市盈率、成交量等。
- 'get_historical_data': 获取指定股票在一定时期内的历史交易数据，包括开盘价、收盘价、最高价、最低价和成交量。

安装步骤

克隆仓库: 打开终端或命令提示符，执行以下命令克隆代码仓库到本地：

git clone https://github.com/MCP-Mirror/9nate-drake_mcp-yfinance

安装依赖: 进入克隆下来的仓库目录 '9nate-drake_mcp-yfinance'，执行以下命令安装项目所需的 Python 库：
```
pip install mcp yfinance
```

服务器配置

要将此 MCP 服务器添加到 Claude Desktop，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。该文件通常位于以下路径（Windows 系统）：'%APPDATA%/Claude/'。

在 'claude_desktop_config.json' 文件的 'mcpServers' 字段中添加以下 JSON 配置。请务必将 '/path/to/finance_server/server.py' 替换为您本地 'server.py' 文件的实际完整路径。

{
  "mcpServers": {
    "yfinance": {  //  服务器名称，将显示在 Claude Desktop 的 🔌 菜单中
      "command": "python", //  运行服务器的命令，这里使用 Python 解释器
      "args": [
        "/path/to/finance_server/server.py"  //  服务器启动参数，指向 server.py 脚本的路径
      ]
    }
  }
}

基本使用方法

重启 Claude Desktop: 完成服务器配置后，重启 Claude Desktop 客户端，使配置生效。
在 🔌 菜单中查找: 在 Claude Desktop 界面中，点击 🔌 菜单，您应该能看到名为 'yfinance' 的服务器。
通过自然语言查询: 现在您可以像与 Claude Desktop 正常对话一样，使用自然语言查询金融数据。以下是一些示例查询：
- 查询微软 (MSFT) 股票的当前价格： "Get me the current stock price for MSFT"
- 分析苹果 (AAPL) 过去 3 个月的股票表现： "Analyse the last 3 months of Apple stock performance"
- 查询英伟达 (NVDA) 的机构所有权比例： "What's the intsitutional ownership of Nvidia?"
- 查询特斯拉 (TSLA) 的目标价中位数： "What's the median price target for TSLA?"

关键词