A-Simple-MCP-Server

🚀 股票价格 MCP 服务器

本项目是一个简单的模型上下文协议（MCP）服务器，借助 yfinance 库为用户提供股票价格信息。它能帮助用户轻松获取和比较股票价格，具有很强的实用性。

🚀 快速开始

此 MCP 服务器提供了获取和比较股票价格的工具。它展示了如何构建一个功能齐全的 MCP 服务器，具备获取当前股票价格、检索历史股票数据、比较不同股票价格以及通过资源接口暴露股票数据等多种能力。

✨ 主要特性

股票价格检索

可获取任何有效股票代码的最新股票价格，并且服务器能够处理市场关闭和无效代码的情况。

历史数据访问

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

股票比较

可通过人类可读的输出比较两个不同股票的价格。

资源暴露

可通过模式 stock://{symbol} 使用资源接口访问股票信息。

📦 安装指南

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

pip install -r requirements.txt

💻 使用示例

基础用法

启动服务器

运行服务器：

python stock_price_server.py

可用工具

该服务器提供以下工具：

# 返回股票的当前价格（格式为浮点数）
get_stock_price(symbol)
# 返回历史股票数据，格式为 CSV
get_stock_history(symbol, period)
# 比较两个股票的价格
compare_stocks(symbol1, symbol2)

使用资源

使用模式 stock://{symbol} 可以访问股票信息，返回格式化的价格信息。

🔧 技术细节

所有函数都包含健壮的错误处理机制，在数据检索失败时返回有意义的错误消息：

• 无效代码返回适当的错误消息
• 网络问题得到妥善处理
• 处理市场关闭情况，并提供备用价格信息

📄 许可证

MIT License