Stock Price MCP Server

Stock Price MCP Server

site icon
2025.04.16 0
Python股票价格金融数据金融服务
Stock Price MCP Server 是一个基于 Model Context Protocol (MCP) 的简单服务器,利用 yfinance 库提供股票价格信息。该服务器具备获取当前股票价格、历史数据、股票比较以及通过资源接口访问股票信息的能力。
View on GitHub

Overview

基本能力

产品定位

Stock Price MCP Server 是一个专注于股票价格数据获取和比较的 MCP 服务器,适用于需要实时或历史股票数据的应用场景。

核心功能

  • 股票价格获取:获取任何有效股票代码的最新价格。
  • 历史数据访问:以 CSV 格式获取不同时间段的股票历史数据(默认为1个月,可自定义)。
  • 股票比较:比较两只不同股票的价格,输出易读的结果。
  • 资源暴露:通过 stock://{symbol} 模式访问股票信息。

适用场景

  • 金融数据分析应用
  • 股票价格监控系统
  • 投资决策支持工具
  • 教育和研究用途

工具列表

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

常见问题解答

  • 无效股票代码:返回适当的错误消息。
  • 网络问题:正确处理网络问题。
  • 市场关闭:使用备用价格信息管理市场关闭情况。

使用教程

使用依赖

  • Python 3.7+
  • mcp-server (Model Context Protocol)
  • yfinance
  • FastAPI
  • Uvicorn

安装依赖命令:

pip install -r requirements.txt

安装教程

  1. 克隆仓库。
  2. 安装依赖:
pip install -r requirements.txt

调试方式

启动服务器:

python stock_price_server.py

使用工具示例:

# 获取股票价格
price = get_stock_price('AAPL')
print(price)

# 获取历史数据
history = get_stock_history('AAPL', '1mo')
print(history)

# 比较股票
comparison = compare_stocks('AAPL', 'MSFT')
print(comparison)

许可证

该项目遵循 MIT 开源许可条款。