使用说明

项目简介

该项目 'mcp-yfinance' 基于 Model Context Protocol (MCP) 构建，是一个专为 Claude Desktop 等 LLM 客户端设计的后端服务器。它利用强大的 'yfinance' 库，能够为 LLM 应用提供实时的股票市场数据和历史数据查询功能。通过这个服务器，LLM 可以方便地获取股票价格、公司信息、财务指标等数据，从而更好地理解用户关于金融市场的提问和分析需求。

主要功能点

实时股票信息查询: 获取指定股票的最新信息，例如当前价格、开盘价、最高价、最低价等。
历史股票数据查询: 获取指定股票在一定时间范围内的历史交易数据，例如日K线数据，支持多种时间周期选择。
丰富的股票指标数据: 提供各种股票的详细指标数据，包括但不限于：
- 价格与交易信息: 当前价格、开盘价、成交量、市值、52周高低价等。
- 公司信息: 公司名称、业务描述、行业、板块、员工人数、网站、地址等。
- 财务指标: 市盈率、市净率、营收、利润、每股收益、股息率等。
- 所有权结构: 机构持股比例、内部持股比例、流通股本等。
- 分析师评级: 分析师建议、目标股价等。

安装步骤

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

git clone https://github.com/9nate-drake/mcp-yfinance

安装依赖包: 进入克隆下来的 'mcp-yfinance' 目录，执行以下命令安装项目所需的 Python 包：
```
pip install mcp yfinance
```
确保你的 Python 版本为 3.10 或更高。

服务器配置

要将 'mcp-yfinance' 服务器配置到 Claude Desktop 中，你需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。该文件通常位于以下路径（Windows）：'%APPDATA%/Claude/'。

在 'claude_desktop_config.json' 文件中，找到 '"mcpServers"' 部分，并添加以下配置信息：

{
  "mcpServers": {
    "yfinance": {  // 服务器名称，可以自定义，将在 Claude Desktop 的 🔌 菜单中显示
      "command": "python", // 启动服务器的命令，这里使用 python
      "args": [
        "/path/to/mcp-yfinance/server.py" // 服务器脚本 server.py 的完整路径，请替换为你的实际路径
      ]
    }
  }
}

请务必将 '/path/to/mcp-yfinance/server.py' 替换为你本地 'server.py' 文件的实际完整路径。 可以使用绝对路径，以确保 Claude Desktop 可以正确找到并启动服务器。

基本使用方法

重启 Claude Desktop: 完成配置后，重启 Claude Desktop 以加载新的服务器配置。
查找并启用服务器: 在 Claude Desktop 界面中，点击左侧菜单栏的 🔌 图标，你应该能在服务器列表中看到名为 "yfinance" 的服务器。点击启用它。
在对话中使用: 现在你可以直接在与 Claude 的对话中提出关于股票市场数据的问题了。以下是一些示例：
- "获取微软 (MSFT) 的当前股价"
- "分析苹果 (AAPL) 过去三个月的股票表现"
- "英伟达 (NVDA) 的机构所有权是多少？"
- "特斯拉 (TSLA) 的分析师目标价中位数是多少？"
Claude 将调用 'mcp-yfinance' 服务器来获取数据，并将结果用于回答你的问题。

关键词