雅虎金融MCP服务器

A. 模型上下文协议（MCP） 服务器，为人工智能助手提供通过以下方式访问雅虎财经数据的权限 雅虎财经。查询股票信息、财经新闻、行业排名，并生成专业的财务图表——所有这些都可以通过你的人工智能聊天。

特性

• 股票数据 —公司信息、财务、估值指标、股息和交易数据
• 财经新闻 —任何股票的最新新闻文章和新闻稿
• 搜索 —在雅虎财经中查找股票、ETF和新闻
• 行业排名 —按行业划分的顶级ETF、共同基金、公司、增长领导者和表现最佳的公司
• 价格历史记录 —历史OHLCV数据，如降价表或专业图表
• 图表生成 —烛台图、VWAP图和成交量曲线图作为WebP图像返回

工具

yfinance_get_ticker_info

检索全面的股票数据，包括公司信息、财务、交易指标和治理数据。

参数	类型	必填	说明
symbol	string	Yes	股票代码（例如。 AAPL, GOOGL, MSFT)

退货： JSON对象，包含公司详细信息、价格数据、估值指标、交易信息、股息、财务和绩效指标。

yfinance_get_ticker_news

获取特定股票的最新新闻文章和新闻稿。

参数	类型	必填	说明
symbol	string	是	股票代码

退货： 包含标题、摘要、发布日期、提供者、URL和缩略图的新闻项JSON数组。

yfinance_search

在雅虎财经搜索股票、ETF和新闻文章。

参数	类型	必填	说明
query	string	是	搜索查询–公司名称、股票代码或关键字
search_type	string	是	"all" （引用+新闻）， "quotes" （仅限股票/ETF），或 "news" （仅限文章）

退货： 根据以下因素匹配报价和/或新闻结果 search_type.

yfinance_get_top

获得市场部门内排名靠前的金融实体。

参数	类型	必填	说明
sector	string	是	市场部门（参见 支持部门 在…下面
top_type	string	是	"top_etfs", "top_mutual_funds", "top_companies", "top_growth_companies"，或 "top_performing_companies"
top_n	number	否	要返回的结果数（默认值： 10，最大值： 100)

退货： 具有相关指标的顶级实体的JSON数组。

支持的行业

Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities

yfinance_get_price_history

获取历史价格数据，并可选择生成技术分析图表。

参数	类型	必填	说明
symbol	string	是	股票代码
period	string	否	时间范围— 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max （默认值： 1mo)
interval	string	否	数据粒度— 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo （默认值： 1d)
chart_type	string	否	要生成的图表（表格数据省略）

图表类型：

值	描述
"price_volume"	带音量条的烛台图
"vwap"	带有成交量加权平均价格叠加的价格图表
"volume_profile"	按价格水平显示交易量分布的烛台图

退货：

• 没有 chart_type：带有日期、开盘、高、低、收盘、成交量、股息和股票拆分列的Markdown表。
• 随着 chart_type：Base64编码的WebP图像，用于高效使用令牌。

用法

通过紫外线（推荐）

1. 安装uv
2. 将以下内容添加到MCP客户端配置中：

JSON``` 1 2 3 4 5 6 7 8{ “mcpServers”: { “yfmcp”: { “command”: “uvx”, “args”: [“yfmcp@latest”] } } }

### 通过Docker


JSON```
1
2
3
4
5
6
7
8{
  "mcpServers": {
    "yfmcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
    }
  }
}

来自源头

1. 克隆存储库并安装依赖项：

BASH``` 1 2 3git clone https://github.com/narumiruna/yfinance-mcp.git cd yfinance-mcp uv sync

1. 将以下内容添加到MCP客户端配置中：


JSON```
1
2
3
4
5
6
7
8
9
10
11
12
13{
  "mcpServers": {
    "yfmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/yfinance-mcp",
        "yfmcp"
      ]
    }
  }
}

替换 /path/to/yfinance-mcp 使用克隆存储库的实际路径。

发展

先决条件

• Python≥3.12
• 紫外线 包管理器

设置

BASH``` 1uv sync —extra dev

### 棉绒和格式


BASH```
1
2uv run ruff check .
uv run ruff format .

类型检查

BASH``` 1uv run ty check src tests

### 测试


BASH```
1uv run pytest -v -s --cov=src tests

演示聊天机器人

请查看其专用存储库中的演示聊天机器人： yfinance mcp演示

许可证

该项目根据 MIT许可证.