项目简介

Yahoo Finance MCP服务器是一个强大的工具,它通过Model Context Protocol (MCP) 为大型语言模型(LLM)客户端提供实时的Yahoo Finance金融数据。它将复杂的金融数据API封装成一系列易于LLM调用的工具,包括股票行情、历史数据、公司信息、新闻、期权数据、市场摘要等。该服务器支持多种传输模式,确保了与不同LLM应用场景的灵活集成。

主要功能点

  • 股票行情与历史数据: 获取实时股票报价和指定时间范围内的历史价格数据。
  • 公司信息与分析: 查询公司概况、财务指标、分析师推荐和研究报告。
  • 市场动态: 获取市场主要指数、热门股票、每日涨跌幅榜单。
  • 金融新闻: 搜索并获取最新的金融新闻文章。
  • 期权数据: 查询股票期权链信息。
  • 财报时间序列数据: 获取详细的财务报表(如利润表、资产负债表、现金流量表)的历史数据。
  • 多传输协议支持: 支持STDIO、SSE(Server-Sent Events)和StreamableHTTP等多种通信协议,方便与各种LLM客户端集成。

安装步骤

您可以选择以下任一方式安装此MCP服务器:

  1. 全局安装 (推荐):
    npm install -g yahoo-finance-mcp
  2. 作为项目依赖安装:
    npm install yahoo-finance-mcp
  3. 从源代码构建:
    git clone https://github.com/phields/yahoo-finance-mcp.git
    cd yahoo-finance-mcp
    npm install
    npm run build

服务器配置

该MCP服务器需要MCP客户端进行配置才能连接和使用。以下是一个示例配置,展示了如何为名为 'yahoo-finance' 的服务器指定启动命令及其参数。您可以将此配置添加到您的MCP客户端配置文件中(例如 'claude_desktop_config.json' 或其他兼容MCP的客户端配置)。

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "npx",
      "args": ["yahoo-finance-mcp"],
      "description": "提供Yahoo Finance金融数据的MCP服务器,包含实时报价、历史数据、公司信息和市场概况等工具。",
      "icon": "https://example.com/yahoo-finance-icon.png" 
    }
  }
}

配置说明:

  • '"yahoo-finance"': 您为该MCP服务器定义的唯一名称。
  • '"command"': 启动服务器的命令,这里是 'npx',因为它通常用于执行npm包中的可执行文件。
  • '"args"': 传递给 'command' 的参数列表,这里是 'yahoo-finance-mcp',即已全局安装的服务器包名。
  • '"description"': (可选) 对服务器功能的简要描述,有助于LLM客户端理解其用途。
  • '"icon"': (可选) 一个图标URL,用于在LLM客户端界面中展示。

基本使用方法

服务器启动后,MCP客户端即可通过JSON-RPC协议与之通信,并调用其提供的金融数据工具。例如,一个LLM客户端可能会向此服务器发送一个请求,调用 'get_quote' 工具来获取特定股票的实时报价。

通过命令行直接运行(使用STDIO传输模式,LLM客户端常用): 如果您已全局安装:

yahoo-finance-mcp

如果您在项目中安装并构建:

npm start

启动SSE或StreamableHTTP传输模式(通常用于Web应用集成): 您可以通过设置环境变量来选择传输类型,例如:

export TRANSPORT_TYPE=sse
npm start
# 或
export TRANSPORT_TYPE=streamableHttp
npm start

具体集成到Web框架(如Hono)的示例,请参考项目的README文档。

信息

分类

商业系统