美股数据服务

一个用于访问和更新美国股票历史价格数据的MCP服务器,支持本地存储、自动更新和安全数据写入。

  • by mingyaw
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mingyaw/us_stock_mcp_server

使用说明

美国股票数据MCP服务器

一种模型上下文协议(MCP)服务器,用于访问和更新美国股票历史价格数据。

特性

  • 本地数据存储:以CSV格式在本地存储股票数据,以便快速访问
  • 自动更新:支持雅虎财经自动更新股票数据
  • 安全数据写入:使用临时文件确保原子和安全的数据写入
  • 灵活的时间范围:可自定义数据更新的开始日期

安装

  1. 确保已安装Python 3.x
  2. 克隆此存储库
  3. 安装依赖项:
pip install -r requirements.txt

用法

1.启动服务器

python server.py

服务器启动后的默认数据存储路径为: ~/Library/Application Support/us-market-data/data

您可以使用自定义数据存储路径 US_STOCK_DATA_DIR 环境变量。

2.可用功能

MCP工具

  1. get_local_stock_data

    • 功能:检索本地股票历史数据
    • 参数:
      • symbol:股票代码,例如“AAPL”、“MSFT”
  2. update_stock_data

    • 功能:更新库存数据
    • 参数:
      • symbol:股票代码,例如“AAPL”、“MSFT”
      • start_date:开始日期采用YYYY-MM-DD格式,默认为2015-01-01

MCP资源

  • 资源URI: usstock://{symbol}/historical
    • 功能:提供美国本地股票历史价格数据
    • 参数:
      • symbol:股票代码

数据格式

存储的库存数据包括以下字段:

  • 日期:交易日期
  • 开盘价:开盘价
  • 高:最高价格
  • 低:最低价格
  • 收盘价:收盘价
  • 交易量:交易量

依赖项

  • mcp:mcp协议实现
  • pandas:数据处理和分析
  • yfinance:雅虎财经数据检索
  • pydantic:数据验证和设置管理

备注

  1. 更新过程中会自动处理重复数据,保留最新记录
  2. 在更新操作之间实现5秒延迟,以避免频繁的API请求
  3. 所有数据操作都包括错误处理,以确保服务稳定性