项目简介
Yahoo Finance MCP服务器是一个强大的工具,它通过Model Context Protocol (MCP) 为大型语言模型(LLM)客户端提供实时的Yahoo Finance金融数据。它将复杂的金融数据API封装成一系列易于LLM调用的工具,包括股票行情、历史数据、公司信息、新闻、期权数据、市场摘要等。该服务器支持多种传输模式,确保了与不同LLM应用场景的灵活集成。
主要功能点
- 股票行情与历史数据: 获取实时股票报价和指定时间范围内的历史价格数据。
- 公司信息与分析: 查询公司概况、财务指标、分析师推荐和研究报告。
- 市场动态: 获取市场主要指数、热门股票、每日涨跌幅榜单。
- 金融新闻: 搜索并获取最新的金融新闻文章。
- 期权数据: 查询股票期权链信息。
- 财报时间序列数据: 获取详细的财务报表(如利润表、资产负债表、现金流量表)的历史数据。
- 多传输协议支持: 支持STDIO、SSE(Server-Sent Events)和StreamableHTTP等多种通信协议,方便与各种LLM客户端集成。
安装步骤
您可以选择以下任一方式安装此MCP服务器:
- 全局安装 (推荐):
npm install -g yahoo-finance-mcp - 作为项目依赖安装:
npm install yahoo-finance-mcp - 从源代码构建:
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文档。
信息
分类
商业系统