Yahoo Finance MCP Server
项目简介
本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,专注于提供 Yahoo Finance 的金融数据查询功能。通过集成 'yfinance' 库,本服务器为大型语言模型 (LLM) 客户端提供了一系列工具,用于获取股票行情、公司新闻、市场信息等。
主要功能点
- 股票信息查询: 获取指定股票代码的详细信息,例如公司简介、财务数据等。
- 股票新闻: 检索指定股票代码的最新新闻资讯。
- 股票代码搜索: 根据关键词搜索股票代码。
- 财经新闻搜索: 根据关键词搜索财经新闻。
- 市场概况: 获取指定市场的概况信息,如市场状态、主要指数等。
- 行业板块信息: 查询行业板块和行业的详细数据,包括行业概况、热门公司等。
- 行业板块与行业映射: 提供行业板块与行业的对应关系,方便用户查找。
安装步骤
- 安装 uv: 请根据 uv 官方文档 安装 'uv'。 'uv' 是项目运行的依赖,用于包管理和环境隔离。
服务器配置
MCP 客户端需要配置以下 JSON 信息以连接到 'Yahoo Finance MCP Server'。 配置时请确保 'command' 和 'args' 的设置正确,以便客户端能够启动并连接到服务器。
{ "mcpServers": { "yfmcp": { "command": "uvx", "args": ["yfmcp"] } } }
配置参数说明:
- 'server name': 'yfmcp' (服务器名称,客户端用此名称引用)
- 'command': 'uvx' (启动服务器的命令,这里使用 'uvx' 启动,确保已安装 'uv')
- 'args': '["yfmcp"]' (传递给 'uvx' 命令的参数,'yfmcp' 是服务器的入口点,对应 'src/yfmcp/server.py' 中的 'main' 函数)
基本使用方法
- 确保 MCP 客户端已正确配置上述服务器信息。
- 客户端可以通过 JSON-RPC 协议调用服务器提供的工具 (Tools) 来获取金融数据。
- 可用的工具包括:
- 'get_ticker_info': 获取股票详细信息,需要股票代码作为参数。
- 'get_ticker_news': 获取股票新闻,需要股票代码作为参数。
- 'search_quote': 搜索股票代码,需要搜索关键词作为参数。
- 'search_news': 搜索财经新闻,需要搜索关键词作为参数。
- 'get_market': 获取市场概况,需要市场名称作为参数 (可选市场名称请参考 'src/yfmcp/types.py' 中的 'Market' 枚举)。
- 'get_sector_industy_mapping': 获取行业板块与行业映射,无需参数。
- 'get_sector': 获取行业板块信息,需要行业板块名称作为参数 (可使用 'get_sector_industy_mapping' 获取可用的行业板块)。
- 'get_industry': 获取行业信息,需要行业名称作为参数 (可使用 'get_sector_industy_mapping' 获取可用的行业)。
注意: 客户端需要根据 MCP 协议规范构建 JSON-RPC 请求,并解析服务器返回的 JSON-RPC 响应。服务器返回的数据通常为 JSON 字符串形式,客户端需要根据工具的返回类型进行解析和使用。
信息
分类
网页与API