yfinance-mcp-server

yfinance-mcp-server

日语版

重要说明：这是一个非官方的 MCP 服务。

一个用于访问 Yahoo Finance 数据的消息控制协议（MCP）服务。此服务通过 yfinance 提供简单的接口来获取股票市场数据。

功能

• 获取历史股票数据，并可自定义时间段和间隔
• 可轻松与任何 MCP 客户端搭配使用
• 使用 TypeScript 构建，确保类型安全并改善开发体验

用法

Cursor MCP 客户端示例。

{
  "mcpServers": {
    "yfinance": {
      "command": "npx",
      "args": [
        "@onori/yfinance-mcp-server"
      ]
    }
  }
}

getStockHistory

获取指定股票代码的历史股票数据。

参数：

• symbol（必填）：股票代码（例如，Apple Inc. 的代码为 "AAPL"）
• period（必填）：要获取数据的时间段（例如，"1d"、"5d"、"1mo"、"3mo"、"6mo"、"1y"、"2y"、"5y"、"10y"、"ytd"、"max"）
• interval（可选）：数据间隔（"1d"、"1wk"、"1mo"）

MCP 请求示例：

> (Request) 
Please use the `getStockHistory` tool to fetch the daily stock data for AAPL for the past week (`period`='1w', `interval`='1d'). Then, render the results as a markdown table.

> (Response Example)
I'll help you fetch Apple's stock data and format it nicely as a markdown table.
First, I'll call the getStockHistory tool to fetch the data:

Let me format this data into a more readable markdown table:

| Date | Open | High | Low | Close | Volume |
|------|------|------|-----|-------|---------|
| Mar 31, 2025 | $217.01 | $225.62 | $216.23 | $222.13 | 65.30M |
| Apr 1, 2025 | $219.81 | $223.68 | $218.90 | $223.19 | 36.41M |
| Apr 2, 2025 | $221.32 | $225.19 | $221.02 | $223.89 | 35.91M |
| Apr 3, 2025 | $205.54 | $207.49 | $201.25 | $203.19 | 103.42M |
| Apr 4, 2025 | $193.89 | $199.88 | $187.34 | $188.38 | 125.57M |

Some notable observations from this data:
- The stock showed significant volatility over this period
- There was a sharp decline in the last two trading days
- Trading volume increased substantially during the declining days, with the highest volume (125.57M shares) on April 4th
- The stock price range was from a high of $225.62 to a low of $187.34 during this period
Would you like any specific analysis of this data or would you like to see different metrics?

开发

设置开发环境：

1. 克隆仓库
2. 安装依赖：

npm install

3. 启动开发服务器：

npm run dev

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

ISC 许可证（ISC）