Yfinance MCP Server

🚀 yfinance-mcp-server

這是一個非官方的MCP服務器，用於訪問雅虎財經數據。它提供了一個簡單的接口，可通過yfinance獲取股票市場數據。

🚀 快速開始

本服務器提供了便捷的方式來獲取股票市場數據，你可以按照以下步驟快速上手。

✨ 主要特性

• 歷史數據獲取：可獲取指定符號的歷史股票數據，並支持自定義時間段和間隔。
• 使用便捷：使用任何MCP客戶端都非常方便。
• 類型安全：使用TypeScript構建，提供類型安全和更好的開發體驗。

📦 安裝指南

要設置開發環境，可按以下步驟操作：

1. 克隆倉庫。
2. 安裝依賴項：

npm install

3. 啟動開發服務器：

npm run dev

💻 使用示例

基礎用法

示例Cursor MCP客戶端：

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

高級用法

getStockHistory

獲取指定符號的歷史股票數據。

參數：

• symbol（必需）：股票代碼（例如，“AAPL”代表蘋果公司）
• period（必需）：要獲取數據的時間段（例如，“1d”，“5d”，“1mo”，“3mo”，“6mo”，“1y”，“2y”，“5y”，“10y”，“ytd”，“max”）
• interval（可選）：數據間隔（“1d”，“1wk”，“1mo”）

示例MCP請求

> (請求) 
請使用`getStockHistory`工具來獲取AAPL過去一週（`period`='1w'，`interval`='1d'）的每日股票數據。然後將結果渲染為一個Markdown表格。

> (響應示例)
我將幫助您獲取蘋果公司的股票數據，並將其格式化為更易讀的Markdown表格。
首先，我將調用getStockHistory工具來獲取數據：

讓我將此數據格式化為更易讀的Markdown表格：

| 日期 | 開盤價 | 最高價 | 最低價 | 收盤價 | 成交量 |
|------|--------|--------|--------|--------|--------|
| 2025年3月31日 | $217.01 | $225.62 | $216.23 | $222.13 | 65.30M |
| 2025年4月1日 | $219.81 | $223.68 | $218.90 | $223.19 | 36.41M |
| 2025年4月2日 | $221.32 | $225.19 | $221.02 | $223.89 | 35.91M |
| 2025年4月3日 | $205.54 | $207.49 | $201.25 | $203.19 | 103.42M |
| 2025年4月4日 | $193.89 | $199.88 | $187.34 | $188.38 | 125.57M |

從這些數據中可以觀察到以下幾點：
- 股票在這一週內表現出顯著的波動性
- 在最後兩天出現了急劇下降
- 在下跌期間交易量大幅增加，其中4月4日成交量最高（125.57M股）
- 在這期間股票價格範圍從高點$225.62到低點$187.34

您是否需要對這些數據進行特定分析或希望看到不同的指標？

🤝 貢獻

歡迎貢獻！請隨時提交Pull Request。

📄 許可證

ISC 許可證 (ISC)