Stock Price MCP Server

股票价格 MCP 服务

一个简单的 Model Context Protocol（MCP）服务，使用 yfinance 库提供股票价格信息。

概述

此 MCP 服务提供用于获取和比较股票价格的工具。它展示了如何构建具有多种功能的实用 MCP 服务：

• 获取当前股票价格
• 获取历史股票数据
• 比较不同股票的价格
• 将股票数据作为资源提供

功能

股票价格查询

查询任意有效股票代码的最新价格。服务可妥善处理市场休市和无效代码的情况。

历史数据访问

以 CSV 格式获取不同时间段的历史股票数据（默认 1 个月，可自定义）。

股票比较

以易于理解的格式比较两只不同股票的价格。

资源提供

使用 stock://{symbol} 模式通过基于资源的接口访问信息。

安装

1. 克隆此仓库
2. 安装所需依赖项：

   pip install -r requirements.txt
   

用法

启动服务

使用以下命令运行服务：

python stock_price_server.py

可用工具

此服务提供以下工具：

1. get_stock_price(symbol)：以浮点数形式返回股票当前价格
2. get_stock_history(symbol, period)：以 CSV 格式返回历史股票数据
3. compare_stocks(symbol1, symbol2)：比较两只股票的价格

使用资源

可使用 stock://{symbol} 模式访问资源，该模式会返回格式化的价格信息。

错误处理

所有函数都包含完善的错误处理机制，在数据获取失败时返回有意义的错误信息：

• 无效代码会返回相应的错误信息
• 妥善处理网络问题
• 市场休市时会使用备用价格信息

要求

• Python 3.7+
• mcp-server（Model Context Protocol）
• yfinance
• FastAPI
• Uvicorn

许可证

MIT 许可证