🚀 yfinance-mcp-server
这是一个非官方的MCP服务器，用于通过yfinance便捷地访问雅虎财经的股票市场数据。
🚀 快速开始
yfinance-mcp-server 是一个用于访问雅虎财经数据的消息控制协议（MCP）服务器，它提供了简单的接口，能让你轻松通过 yfinance 获取股票市场数据。
✨ 主要特性
- 历史数据获取：可获取指定符号的历史股票数据，还支持自定义时间段和时间间隔。
- 使用便捷：能与任何 MCP 客户端方便地配合使用。
- 类型安全：使用 TypeScript 构建，提供类型安全和更好的开发体验。
📦 安装指南
要设置开发环境，可按以下步骤操作：
- 克隆仓库。
- 安装依赖项：
npm install
- 启动开发服务器：
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)。
⚠️ 重要提示
这是一个非官方的 MCP 服务器。